# Handles

Roblox Engine API class from Roblox Studio 0.744.0.7441077 (version-7aaa6838d36c4448).

- Inherits from, nearest first: [HandlesBase](https://rapi.sleaze.dev/classes/HandlesBase.md), [PartAdornment](https://rapi.sleaze.dev/classes/PartAdornment.md), [GuiBase3d](https://rapi.sleaze.dev/classes/GuiBase3d.md), [GuiBase](https://rapi.sleaze.dev/classes/GuiBase.md), [Instance](https://rapi.sleaze.dev/classes/Instance.md), [Object](https://rapi.sleaze.dev/classes/Object.md)
- Memory category: Instances
- HTML page: https://rapi.sleaze.dev/classes/Handles/
- Roblox documentation: https://create.roblox.com/docs/reference/engine/classes/Handles

Places 3D handles around any object that its [`Adornee`](https://rapi.sleaze.dev/classes/PartAdornment.md) is set to.

## Properties

### Style

```luau
Handles.Style: Enum.HandlesStyle = Enum.HandlesStyle.Resize
```

- Tags: Read capabilities: Basic + Input + UI

Sets the GUI style of the handles.

### Faces

```luau
Handles.Faces: Faces = Right, Top, Back, Left, Bottom, Front
```

- Tags: Read capabilities: Basic + Input + UI

Sets which sides the GUI handles will appear.

### MouseButton1DownConnectionCount

```luau
Handles.MouseButton1DownConnectionCount: number = 0
```

- Tags: Hidden, Not scriptable, Read capabilities: Basic + Input + UI

### MouseButton1UpConnectionCount

```luau
Handles.MouseButton1UpConnectionCount: number = 0
```

- Tags: Hidden, Not scriptable, Read capabilities: Basic + Input + UI

### MouseDragConnectionCount

```luau
Handles.MouseDragConnectionCount: number = 0
```

- Tags: Hidden, Not scriptable, Read capabilities: Basic + Input + UI

### MouseEnterConnectionCount

```luau
Handles.MouseEnterConnectionCount: number = 0
```

- Tags: Hidden, Not scriptable, Read capabilities: Basic + Input + UI

### MouseLeaveConnectionCount

```luau
Handles.MouseLeaveConnectionCount: number = 0
```

- Tags: Hidden, Not scriptable, Read capabilities: Basic + Input + UI

## Events

### MouseButton1Down

```luau
Handles.MouseButton1Down: RBXScriptSignal<(face: Enum.NormalId)>
```

- Tags: Capabilities: Basic + Input + UI

Fired when the left mouse button goes down on one of the GUI handles.

### MouseButton1Up

```luau
Handles.MouseButton1Up: RBXScriptSignal<(face: Enum.NormalId)>
```

- Tags: Capabilities: Basic + Input + UI

Fired when the left mouse button is released on one of the GUI handles.

### MouseDrag

```luau
Handles.MouseDrag: RBXScriptSignal<(face: Enum.NormalId, distance: number)>
```

- Tags: Capabilities: Basic + Input + UI

Fired when the mouse moves while the MouseButton1Down event has fired, but the left mouse button has not been released yet.

### MouseEnter

```luau
Handles.MouseEnter: RBXScriptSignal<(face: Enum.NormalId)>
```

- Tags: Capabilities: Basic + Input + UI

Fired when a mouse "enters" the GUI handle.

### MouseLeave

```luau
Handles.MouseLeave: RBXScriptSignal<(face: Enum.NormalId)>
```

- Tags: Capabilities: Basic + Input + UI

Fired when the mouse leaves the GUI handle.

## Inherited members

- From [PartAdornment](https://rapi.sleaze.dev/classes/PartAdornment.md): `Adornee`
- From [GuiBase3d](https://rapi.sleaze.dev/classes/GuiBase3d.md): `Color3`, `Transparency`, `Color`, `Visible`
- From [Instance](https://rapi.sleaze.dev/classes/Instance.md): `Archivable`, `archivable`, `Attributes`, `AttributesReplicate`, `AttributesSerialize`, `HistoryId`, `Name`, `Parent`, `PredictionMode`, `PropertyStatusStudio`, `RobloxLocked`, `SerializedOverrides`, `SourceAssetId`, `Tags`, `UniqueId`, `numExpectedDirectChildren`, `DataCost`, `Capabilities`, `DefinesCapabilities`, `IsInSandbox`, `Sandboxed`, `AddTag`, `ClearAllChildren`, `Clone`, `Destroy`, `FindFirstAncestor`, `FindFirstAncestorOfClass`, `FindFirstAncestorWhichIsA`, `FindFirstChild`, `FindFirstChildOfClass`, `FindFirstChildWhichIsA`, `FindFirstDescendant`, `GetActor`, `GetAttribute`, `GetAttributeChangedSignal`, `GetAttributes`, `GetChildren`, `GetDebugId`, `GetDescendants`, `GetFullName`, `GetStyled`, `GetStyledPropertyChangedSignal`, `GetTags`, `HasTag`, `IsAncestorOf`, `IsDescendantOf`, `IsPropertyModified`, `QueryDescendants`, `RemoveTag`, `ResetPropertyToDefault`, `SetAttribute`, `WaitForChild`, `Remove`, `children`, `clone`, `destroy`, `findFirstChild`, `getChildren`, `isDescendantOf`, `remove`, `AncestryChanged`, `AttributeChanged`, `ChildAdded`, `ChildRemoved`, `DescendantAdded`, `DescendantRemoving`, `Destroying`, `StyledPropertiesChanged`, `childAdded`
- From [Object](https://rapi.sleaze.dev/classes/Object.md): `ClassName`, `className`, `GetPropertyChangedSignal`, `IsA`, `isA`, `Changed`