GuiObject
GuiObject : GuiBase2d
Overview
The GuiObject class is an abstract class that serves as the foundation for all 2D user interface objects. It defines essential properties and behaviors for displaying GUI elements within the Roblox platform. As an abstract class, GuiObject cannot be instantiated directly but is extended by various specific UI classes like Frame, TextLabel, and ImageButton.
Description
The GuiObject class provides a comprehensive framework for creating and managing 2D graphical user interface elements. It includes a wide range of properties, methods, and events that facilitate the customization and interaction of UI components.
Properties
Active
bool
Active indicates whether a specific GUI element is active, enabled for interaction, or visibly present
Code Samples
Position
UDim2
Specifies where the GUI element is placed on the screen.
Code Samples
Rotation
number
Rotation represents the degree of rotation applied to these GUI object
Code Samples
Size
UDim2
Determines the size of the GUI element.
Code Samples
Visible
bool
Visible determines whether the GUI element is displayed (true) or hidden (false) on the screen. A hidden GUI element ( Visible set to false) will not be rendered but may still exist in the hierarchy and its properties can be accessed or modified.
Code Samples
AnchorPoint
Vector2
AnchorPoint determines the pivot point of the GUI object relative to its position. The value is a Vector2, where (0,0) corresponds to the top-left corner, and (1,1) corresponds to the bottom-right corner. Adjusting the anchor point is useful for aligning GUI elements at specific positions without manually recalculating their placement.
Code Samples
ZIndex
number
ZIndex determines the rendering order of GUI elements. GUI elements with higher ZIndex values will appear above elements with lower ZIndex values, allowing you to control the layering of UI components. This property is particularly useful when designing complex user interfaces with overlapping elements.
Code Samples
BackgroundColor3
Color3
BackgroundColor3 is a property that determines the background color of the GUI object. It is a Color3 value that allows you to specify colors using RGB (red, green, blue) values. By adjusting this property, you can customize the appearance of your GUI element to complement the overall design of your interface.
The value can be set using Color3.new(r, g, b), where r, g, and b are numbers ranging from 0 to 1, or using predefined Color3 values.
Code Samples
BackgroundTransparency
number
BackgroundTransparency determines the transparency level of the background of the GUI object. It is a number value that ranges from 0 (completely opaque) to 1 (completely transparent). By setting this property, you can control the visibility of the background, allowing for more versatile designs.