Roblox UtilitiesDevlHub Roblox Documentation

Class

HandleAdornment

NotCreatable
Inherits
PVAdornment › GuiBase3d › GuiBase › Instance › Object
Memory category
Instances
Subclasses
8

An abstract class inherited by 3D handle adornments.

HandleAdornment is an abstract class inherited by 3D handle adornments. If parented to a player's PlayerGui or the CoreGui, handles can listen to input events for purposes such as making dragger tools.

Properties 5#

AdornCullingModeAdornCullingModeDetermines whether to automatically cull the adornment.ReadSafe
AlwaysOnTopbooleanForces this adornment to render on top of all 3D objects in the workspace.ReadSafe
CFrameCFrameThe position and rotation of the object relative to its PVAdornment.Adornee.ReadSafe
SizeRelativeOffsetVector3The positional offset of the adornment based on the adornee's BasePart.Size.ReadSafe
ZIndexintDetermines the draw order of this HandleAdornment when AlwaysOnTop is true.ReadSafe

AdornCullingMode: AdornCullingMode#

ReadSafe

This property determines whether to automatically cull the adornment based on distance from the camera.

AlwaysOnTop: boolean#

ReadSafe

If true, forces this adornment to render on top of all 3D objects in the workspace. As an exception, setting ZIndex to -1 will override an AlwaysOnTop value of true and cause the adornment to appear either in front of or behind other adornments and objects based on their relative position in the 3D space.

CFrame: CFrame#

ReadSafe

CFrame position and rotation relative to its PVAdornment.Adornee, applied after any translations due to SizeRelativeOffset.

SizeRelativeOffset: Vector3#

ReadSafe

By default, an adornment draws in the center of its Adornee, but this property shifts the adornment's relative position based on the adornee's BasePart.Size.

Note that the units of SizeRelativeOffset are a scale based on the size of the adornee itself, such that a value of 1 will move the adornment to the corresponding edge of the adornee. For example, a value of Datatype.Vector3.new(0, 1, 0) will shift the adornment to the exact top of its adornee.

ZIndex: int#

ReadSafe

Only applies if AlwaysOnTop is true and determines the draw order of this HandleAdornment relative to other adornments. It does not relate to the ZIndex property for GuiObjects.

Valid values are from -1 to 10 with higher values drawing on top (in front) of lesser values. This drawing order will be respected even if an adornment is in front of or behind another adornment in the 3D space.

As an exception, setting ZIndex to -1 or AlwaysOnTop to false will cause the adornment to appear either in front of or behind other adornments and objects based on their relative position in the 3D space.

Events 4#

MouseButton1DownFires when a player presses down on their left mouse button while hovering over the adornment.
MouseButton1UpFires when a player releases their left mouse button while hovering over the adornment.
MouseEnterFires when a player moves their mouse over the adornment.
MouseLeaveFires when a player moves their mouse out of the adornment.

MouseButton1Down()#

This event fires when a player presses down their left mouse button while hovering over the adornment. Only fires if the adornment is parented to a player's PlayerGui or the CoreGui.

MouseButton1Up()#

This event fires when a player releases their left mouse button while hovering over the adornment. Only fires if the adornment is parented to a player's PlayerGui or the CoreGui.

MouseEnter()#

This event fires when a player moves their mouse over the adornment. Only fires if the adornment is parented to a player's PlayerGui or the CoreGui.

MouseLeave()#

This event fires when a player moves their mouse out of the adornment. Only fires if the adornment is parented to a player's PlayerGui or the CoreGui.

Inherited members#

Inherited from PVAdornment 1
Properties (1)

Adornee

Inherited from GuiBase3d 4
Properties (4)

Color, Color3, Transparency, Visible

Inherited from Instance 58
Inherited from Object 6
Properties (2)

ClassName, className

Events (1)

Changed

Subclasses 8#