SelectedObject

Description:

Sets the GuiObject currently being focused on by the GUI Navigator (used for Gamepads). This may reset to nil if the object is off-screen.

This property is changed by the GuiObject/SelectionGained and GuiObject/SelectionLost events.

If you would like to determine when this property changes without tracking the SelectionGained and SelectionLost events for all GUI elements, you can use the Instance/Changed|Changed event.

Code Samples

Printing When Gamepad Selection Changes

The code below demonstrates how to handle when the SelectedObject changes. For instance, this event fires when the Gamepad navigates to another GUI element.

			
				Printing When Gamepad Selection Changes

				Expected Output
			
				Expand
				
			local GuiService = game:GetService("GuiService")

local function printChanged(value)
	if value == "SelectedObject" then
		print("The SelectedObject changed!")
	end
end

GuiService.Changed:Connect(printChanged)
		
				Copy Code
			
				Light Theme