GuiBase2d
GuiBase2d is an abstract class inherited by 2D GuiObjects.
Summary
Properties
Describes the actual screen position of a GuiBase2d element, in pixels.
Describes the actual screen rotation of a GuiBase2d element, in degrees.
Describes the actual screen size of a GuiBase2d element, in pixels.
When set to true, localization will be applied to this GuiBase2d and its descendants.
A reference to a LocalizationTable to be used to apply automated localization to this GuiBase2d and its descendants.
Customizes gamepad selection behavior in the down direction.
Customizes gamepad selection behavior in the left direction.
Customizes gamepad selection behavior in the right direction.
Customizes gamepad selection behavior in the up direction.
Allows customization of gamepad selection movement.
Events
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Fires when the gamepad selection moves to, leaves, or changes within the connected GuiBase2d or any descendant GuiObjects.
Properties
AbsolutePosition
AbsolutePosition is a read-only property that provides the screen position of a GuiBase2d element in pixels. This represents the actual pixel position at which an element renders as a result of its ancestors' sizes and positions. Note that the object's AnchorPoint influences AbsolutePosition.
See also AbsoluteRotation and AbsoluteSize.
AbsoluteRotation
AbsoluteRotation is a read-only property that describes the actual screen rotation of a GuiBase2d element, in degrees. It does not perform bounds checking, so its value may not be in the range 0 to 360.
See also AbsolutePosition and AbsoluteSize.
AbsoluteSize
AbsoluteSize is a read-only property that describes the actual screen size of a GuiBase2d element, in pixels.
See also AbsolutePosition and AbsoluteRotation.
AutoLocalize
When set to true, localization will be applied to this GuiBase2d and its descendants. The entries used for localization are the same set of entries returned by LocalizationService:GetTableEntries(). Entries with AutoLocalize enabled are automatically re-translated after the cloud table loads if necessary.
See also RootLocalizationTable.
RootLocalizationTable
A reference to a LocalizationTable to be used to apply automated localization to this GuiBase2d and its descendants. AutoLocalize must be set to true on the GuiBase2d and its ancestors for automated localization to be applied.
You can set this to reference a LocalizationTable anywhere in the DataModel. The GuiBase2d object and all of its children will try to use that specific LocalizationTable and its ancestors for automatic text replacement before using the tables under LocalizationService in an undefined order and the cloud table.
If there is no translation available in the referenced table, it will look for a translation in the parent of that table, if it is also a LocalizationTable, and so on.
See also LocalizationService:GetTableEntries() which explains how the RootLocalizationTable is used for automated localization.
SelectionBehaviorDown
Customizes gamepad selection behavior in the down direction.
SelectionBehaviorLeft
Customizes gamepad selection behavior in the left direction.
SelectionBehaviorRight
Customizes gamepad selection behavior in the right direction.
SelectionGroup
Allows for customization of how gamepad selection can move between buttons, which are descendants of the selection group, leave the group, and select other buttons.
Setting SelectionGroup to true exposes the SelectionBehaviorUp, SelectionBehaviorDown, SelectionBehaviorLeft, and SelectionBehaviorRight properties. For these selection behaviors, a setting of Enum.SelectionBehavior.Escape (default) means the gamepad selection tries to first find a selection within the selection group and only moves outside if it does not find a suitable button. Alternatively, a setting of Enum.SelectionBehavior.Stop means gamepad selection only looks within the selection group and does not move outside of the group from the selection behavior direction.
Methods
Events
SelectionChanged
This event fires when the gamepad selection moves to, leaves, or changes within the connected GuiBase2d or any descendant GuiObjects. When the selection highlight moves to a GuiObject, the event bubbles from that GuiObject to all of its ancestors, informing them that the selection has changed/entered/exited to a GuiObject in their descendant tree.
Parameters
True if the new selection matches the attached GuiBase2d.