`Class.GuiButton` est une classe abstraite qui hérite de `Class.GuiObject`.
C'est la classe de base pour les objets interactifs et cliquables `Class.ImageButton` et
`Class.TextButton`. Cette classe définit également plusieurs propriétés pour
le comportement interactif, à savoir `Class.GuiButton.AutoButtonColor|AutoButtonColor`
et `Class.GuiButton.Modal|Modal`.

L'événement le plus important d'un `Class.GuiButton` est
`Class.GuiButton.Activated|Activated`, un **événement multi-plateforme** qui se déclenche
lorsque le bouton est activé. Lors de l'utilisation d'une souris, cela signifie cliquer sur le
bouton et relâcher tout en maintenant le curseur au-dessus de l'objet UI. Pour le tactile,
la même logique s'applique mais avec un toucher au lieu d'une pression de bouton. Enfin, pour les manettes,
`Class.GuiButton.Activated|Activated` se déclenche si un `Class.GuiButton` est sélectionné
lorsque le bouton **A** est pressé et relâché. En résumé, cet événement est très
utile pour la programmation d'interfaces utilisateurs multi-plateformes car il fournit une belle
interface générale pour une seule entrée utilisateur.

Déclenche lorsqu'un clic gauche pressé et relâché est détecté sur desktop, un relâchement tactile est détecté sur mobile, ou que **A**/croix est activé en mode de navigation UI sur console.

Comme cet événement ne se déclenche pas sur le serveur, il ne doit être utilisé que dans un
`Class.LocalScript`, ou dans un `Class.Script` avec
`Class.Script.RunContext|RunContext` de `Enum.RunContext.Client`.

GuiButton.Activated

inputObject

clickCount

Se déclenche lorsque le bouton est activé.

Cet événement se déclenche lorsque la souris de l'utilisateur clique complètement à gauche sur le
`Class.GuiButton`.

En ce qui concerne le clic, la souris doit être dans les limites du
`Class.GuiButton` et le bouton de la souris doit être enfoncé et relâché à nouveau
avant que cet événement ne se déclenche. Si la souris quitte les limites du
`Class.GuiButton` et est relâchée, l'événement ne se déclenchera pas. Si vous souhaitez
éviter cette limitation, vous pouvez utiliser
`Class.GuiButton.MouseButton1Down|MouseButton1Down` et
`Class.GuiButton.MouseButton1Up|MouseButton1Up`; ces événements sont similaires
mais se déclencheront chaque fois que l'utilisateur appuie sur son bouton gauche de souris ou
le relâche, respectivement.

GuiButton.MouseButton1Click

Se déclenche lorsque la souris de l'utilisateur clique complètement à gauche sur le `Class.GuiButton`.

Cet événement se déclenche lorsque l'utilisateur enfonce son bouton gauche de souris sur le
`Class.GuiButton`.

Pour un événement nécessitant que l'utilisateur appuie **et** relâche son bouton gauche de souris
sur un `Class.GuiButton` afin que l'événement se déclenche, envisagez d'utiliser
`Class.GuiButton.MouseButton1Click|MouseButton1Click`.

GuiButton.MouseButton1Down

La coordonnée **X** de l'écran de la souris en pixels.

La coordonnée **Y** de l'écran de la souris en pixels.

Se déclenche lorsque l'utilisateur enfonce son bouton gauche de souris sur le
`Class.GuiButton`.

Cet événement se déclenche lorsque l'utilisateur relâche son bouton gauche de souris du
`Class.GuiButton`.

Pour un événement nécessitant que l'utilisateur appuie **et** relâche son bouton gauche de souris
sur un `Class.GuiButton` afin que l'événement se déclenche, envisagez d'utiliser
`Class.GuiButton.MouseButton1Click|MouseButton1Click`.

GuiButton.MouseButton1Up

Se déclenche lorsque l'utilisateur relâche son bouton gauche de souris du
`Class.GuiButton`.

Cet événement se déclenche lorsque la souris de l'utilisateur clique complètement à droite sur le
`Class.GuiButton`.

En ce qui concerne le clic, la souris doit être dans les limites du
`Class.GuiButton` et le bouton de la souris doit être enfoncé et relâché à nouveau
avant que cet événement ne se déclenche. Si la souris quitte les limites du
`Class.GuiButton` et est relâchée, l'événement ne se déclenchera pas. Si vous souhaitez
éviter cette limitation, vous pouvez utiliser
`Class.GuiButton.MouseButton2Down|MouseButton2Down` et
`Class.GuiButton.MouseButton2Up|MouseButton2Up`; ces événements sont similaires
mais se déclencheront chaque fois que l'utilisateur appuie sur son bouton droit de souris ou
le relâche, respectivement.

GuiButton.MouseButton2Click

Se déclenche lorsque la souris de l'utilisateur clique complètement à droite sur le `Class.GuiButton`.

Cet événement se déclenche lorsque l'utilisateur enfonce son bouton droit de souris sur
le `Class.GuiButton`.

Pour un événement nécessitant que l'utilisateur appuie **et** relâche son bouton droit de souris
sur un `Class.GuiButton` afin que l'événement se déclenche, envisagez d'utiliser
`Class.GuiButton.MouseButton2Click|MouseButton2Click`.

GuiButton.MouseButton2Down

Se déclenche lorsque l'utilisateur enfonce son bouton droit de souris sur le
`Class.GuiButton`.

Cet événement se déclenche lorsque l'utilisateur relâche son bouton droit de souris du
`Class.GuiButton`.

Pour un événement nécessitant que l'utilisateur appuie **et** relâche son bouton droit de souris
sur un `Class.GuiButton` afin que l'événement se déclenche, envisagez d'utiliser
`Class.GuiButton.MouseButton2Click|MouseButton2Click`.

GuiButton.MouseButton2Up

Se déclenche lorsque l'utilisateur relâche son bouton droit de souris du
`Class.GuiButton`.

Se déclenche lorsqu'un clic droit pressé et relâché est détecté depuis une souris, qu'un appui long est détecté sur une entrée tactile, que `R3` est détecté depuis une manette, ou que
<kbd>Alt</kbd><kbd>Enter</kbd> est détecté en mode de navigation UI avec
un clavier.


GuiButton.SecondaryActivated

L'objet d'entrée représentant l'action d'activation alternative.

Se déclenche lorsque l'entrée "secondaire" du bouton est activée.

GuiButton

Cette propriété détermine si le bouton change automatiquement de couleur
lorsque le `Class.Mouse` de l'utilisateur le survole ou clique dessus. Si `true`, le
bouton changera automatiquement de couleur lorsque la souris le survolera ou
cliquera dessus. Si `false`, le bouton ne changera pas.

Si vous souhaitez personnaliser la façon dont un bouton change lorsque la souris
survole ou clique dessus, envisagez d'utiliser un `Class.ImageButton` et
de changer les propriétés `Class.ImageButton.HoverImage|HoverImage` et
`Class.ImageButton.PressedImage|PressedImage` de l'élément.

Veuillez noter que cette propriété n'aura pas d'effet sur un
`Class.ImageButton` si sa propriété `Class.ImageButton.Image|Image` est définie
sur une image. De plus, cette propriété n'affectera pas un
`Class.ImageButton` au survol de la souris lorsque sa
`Class.ImageButton.HoverImage|HoverImage` n'est pas `nil`, ni sur un clic de souris
si son `Class.ImageButton.PressedImage|PressedImage` n'est pas `nil`.

GuiButton.AutoButtonColor

Détermine si le bouton change automatiquement de couleur lorsque la souris
le survole ou clique dessus.

Une instance de `Class.HapticEffect` qui sera jouée lorsque le `Class.GuiButton`
est survolé.

GuiButton.HoverHapticEffect

Si `true` pendant que l'élément GUI est visible, la souris ne sera pas verrouillée
à moins que le bouton droit de la souris soit enfoncé.

GuiButton.Modal

Une instance de `Class.HapticEffect` qui sera jouée lorsque le `Class.GuiButton`
est enfoncé.

GuiButton.PressHapticEffect

Une propriété booléenne qui indique si l'objet a été sélectionné.

GuiButton.Selected

Définit le style du `Class.GuiButton` en fonction d'une liste de styles prédéterminés.

GuiButton.Style

Une classe abstraite pour les éléments de l'interface utilisateur 2D interactifs.

`Class.GuiObject` est une classe abstraite (tout comme `Class.BasePart`) pour un objet d'interface utilisateur 2D. Elle définit toutes les propriétés liées à l'affichage d'un objet d'interface graphique (GUI) tel que `Class.GuiObject.Size|Size` et `Class.GuiObject.Position|Position`. Elle a également certaines propriétés en lecture seule utiles comme `Class.GuiObject.AbsolutePosition|AbsolutePosition`, `Class.GuiObject.AbsoluteSize|AbsoluteSize`, et `Class.GuiObject.AbsoluteRotation|AbsoluteRotation`.

Pour manipuler la mise en page des objets GUI de manière spéciale, vous pouvez utiliser une structure de mise en page telle que [list/flex](/ui/list-flex-layouts) ou [grid](/ui/grid-table-layouts), et vous pouvez les styliser au-delà de leurs propriétés fondamentales grâce aux [modificateurs d'apparence](/ui/appearance-modifiers).

Bien qu'il soit possible de détecter les événements de bouton de souris sur tout objet GUI en utilisant `Class.GuiObject.InputBegan|InputBegan` et `Class.GuiObject.InputEnded|InputEnded`, seuls `Class.ImageButton` et `Class.TextButton` disposent d'événements dédiés pratiques tels que `Class.TextButton.Activated|Activated` pour détecter un clic/appui.

L'exemple ci-dessous suppose qu'il est dans un GuiObject tel qu'un `TextButton`, et
que la propriété `Class.GuiObject.Draggable` est définie sur true. Il imprimera
le UDim2 à partir duquel le joueur a commencé à faire glisser l'objet.

Cet événement se déclenche lorsque le joueur commence à faire glisser l'objet.

Voir aussi `Class.GuiObject.DragStopped`.

GuiObject.DragBegin

initialPosition

Une valeur `Datatype.UDim2` de la position du `Class.GuiObject` avant le début de l'opération de glissement.

Déclenché lorsque le joueur commence à faire glisser l'objet.

L'exemple ci-dessous suppose qu'il se trouve dans un GuiObject tel qu'un `TextButton`, et
que la propriété `Class.GuiObject.Draggable` est définie sur true. Il imprimera
les coordonnées X et Y de l'endroit où le joueur a arrêté de glisser le GUI. Par exemple, si le
joueur arrêtait de glisser l'objet à 189, 180, cela imprimerait : Le
joueur a arrêté de glisser le GuiObject à (189, 180)

Cet événement se déclenche lorsque le joueur arrête de faire glisser l'objet.

Voir aussi `Class.GuiObject.DragBegin`.

GuiObject.DragStopped

La position **X** de la souris à l'écran en pixels, relative au coin supérieur gauche de l'écran.

La position **Y** de la souris à l'écran en pixels, relative au coin supérieur gauche de l'écran.

Déclenché lorsque le joueur arrête de faire glisser l'objet.

L'exemple suivant démontre l'un des nombreux exemples d'utilisation de la gestion de l'entrée utilisateur
à partir de InputBegan en fonction de son type.

Pour que cela fonctionne comme prévu, il doit être placé dans un `LocalScript`
et un enfant de _gui_.

Cet événement se déclenche lorsqu'un utilisateur interagit avec le `Class.GuiObject` via un dispositif d'interface homme-machine (bouton de souris enfoncé, début de toucher, bouton de clavier enfoncé, etc).

Le `Class.UserInputService` a un événement de nom similaire qui n'est pas restreint à un élément UI spécifique : `Class.UserInputService.InputBegan`.

Cet événement se déclenche toujours, quelle que soit l'état du jeu.

Voir aussi `Class.GuiObject.InputEnded` et `Class.GuiObject.InputChanged`.

GuiObject.InputBegan

input

Un `Class.InputObject`, qui contient des données utiles pour interroger l'entrée de l'utilisateur
comme le `Enum.UserInputType|type d'entrée`,
`Enum.UserInputState|état de l'entrée`, et
`Class.InputObject.Position|coordonnées à l'écran de l'entrée`.

Déclenché lorsqu'un utilisateur commence à interagir via un dispositif d'interface homme-machine (bouton de souris enfoncé, début de toucher, bouton de clavier enfoncé, etc).

L'exemple suivant illustre l'un des nombreux exemples d'utilisation de la gestion de l'
intrant utilisateur à partir d'InputChanged selon son type.

Pour que cela fonctionne comme prévu, il doit être placé dans un `LocalScript`
et un enfant de _gui_.

Cet événement se déclenche lorsqu'un utilisateur change son mode d'interaction via un dispositif d'interface homme-machine (bouton de souris enfoncé, début de toucher, bouton de clavier enfoncé, etc).

Le `Class.UserInputService` a un événement de nom similaire qui n'est pas restreint à un élément UI spécifique : `Class.UserInputService.InputChanged`.

Cet événement se déclenche toujours, quelle que soit l'état du jeu.

Voir aussi `Class.GuiObject.InputBegan` et `Class.GuiObject.InputEnded`.

GuiObject.InputChanged

Déclenché lorsqu'un utilisateur change son mode d'interaction via un dispositif d'interface homme-machine (bouton de souris enfoncé, début de toucher, bouton de clavier enfoncé, etc).

L'exemple suivant démontre l'un des nombreux exemples d'utilisation de la gestion des entrées
utilisateur de InputEnded en fonction de leur type.

Pour que cela fonctionne comme prévu, cela doit être placé dans un `LocalScript`
et être un enfant de _gui_.

L'événement InputEnded se déclenche lorsque l'utilisateur arrête d'interagir via un dispositif d'interface homme-machine (bouton de souris enfoncé, début de toucher, bouton de clavier enfoncé, etc).

Le `Class.UserInputService` a un événement de nom similaire qui n'est pas restreint à un élément UI spécifique : `Class.UserInputService.InputEnded`.

Cet événement se déclenche toujours, quelle que soit l'état du jeu.

Voir aussi `Class.GuiObject.InputBegan` et `Class.GuiObject.InputChanged`.

GuiObject.InputEnded

Un `Class.InputObject`, qui contient des données utiles pour interroger l'entrée de l'utilisateur
comme le `Enum.UserInputType`, `Enum.UserInputState`, et
`Class.InputObject.Position`.

Déclenché lorsqu'un utilisateur arrête d'interagir via un dispositif d'interface homme-machine (bouton de souris enfoncé, début de toucher, bouton de clavier enfoncé, etc).

L'exemple suivant imprime la position de la souris, en pixels, lorsqu'elle entre dans un élément GUI.

L'événement MouseEnter se déclenche lorsqu'un utilisateur déplace sa souris dans un élément `Class.GuiObject`.

Veuillez ne pas vous fier aux arguments `x` et `y` transmis par cet événement comme moyen infaillible de déterminer où se trouve la souris de l'utilisateur lorsqu'elle entre dans un GUI. Ces coordonnées peuvent varier même lorsque la souris entre dans le GUI par le même bord - en particulier lorsque la souris entre rapidement dans l'élément. Cela est dû au fait que les coordonnées indiquent la position de la souris au moment où l'événement se déclenche plutôt que le moment exact où la souris entre dans le GUI.

Cet événement se déclenche même lorsque l'élément GUI est rendu sous un autre élément.

Si vous souhaitez suivre lorsque la souris d'un utilisateur quitte un élément GUI, vous pouvez utiliser l'événement `Class.GuiObject.MouseLeave`.

##### Voir Aussi

- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelForward`
- `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseEnter

La coordonnée **X** de la souris à l'écran en pixels, relative au coin supérieur gauche de l'écran.

La coordonnée **Y** de la souris à l'écran en pixels, relative au coin supérieur gauche de l'écran.

Se déclenche lorsqu'un utilisateur déplace sa souris dans un élément GUI.

L'événement MouseLeave se déclenche lorsque l'utilisateur déplace sa souris hors d'un élément `Class.GuiObject`.

Veuillez ne pas vous fier aux arguments `x` et `y` transmis par cet événement comme moyen infaillible de déterminer où se trouve la souris de l'utilisateur lorsqu'elle quitte un GUI. Ces coordonnées peuvent varier même lorsque la souris quitte le GUI par le même bord - en particulier lorsque la souris quitte rapidement l'élément. Cela est dû au fait que les coordonnées indiquent la position de la souris au moment où l'événement se déclenche plutôt que le moment exact où la souris quitte le GUI.

Cet événement se déclenche même lorsque l'élément GUI est rendu sous un autre élément.

##### Voir Aussi

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelForward`
- `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseLeave

Se déclenche lorsqu'un utilisateur déplace sa souris hors d'un élément GUI.

Se déclenche chaque fois qu'un utilisateur déplace sa souris alors qu'elle est à l'intérieur d'un élément `Class.GuiObject`. C'est similaire à `Class.Mouse.Move`, qui se déclenche indépendamment de si la souris de l'utilisateur est sur un élément GUI.

Notez que cet événement se déclenche lorsque la position de la souris est mise à jour, il se déclenchera donc à plusieurs reprises lors du mouvement.

Les arguments `x` et `y` indiquent les coordonnées d'écran mises à jour de la souris de l'utilisateur en pixels. Cela peut être utile pour déterminer la position de la souris sur le GUI, l'écran, et le delta par rapport à la position précédente de la souris si elle est suivie dans une variable globale.

Le code ci-dessous montre comment déterminer l'offset `Datatype.Vector2` de la souris de l'utilisateur par rapport à un élément GUI :

```lua
local Players = game:GetService("Players")

local CustomScrollingFrame = script.Parent
local SubFrame = CustomScrollingFrame:FindFirstChild("SubFrame")

local mouse = Players.LocalPlayer:GetMouse()

local function getPosition(X, Y)
	local gui_X = CustomScrollingFrame.AbsolutePosition.X
	local gui_Y = CustomScrollingFrame.AbsolutePosition.Y


	local pos = Vector2.new(math.abs(X - gui_X), math.abs(Y - gui_Y - 36))
	print(pos)
end

CustomScrollingFrame.MouseMoved:Connect(getPosition)
```
Notez que cet événement peut ne pas se déclencher exactement au moment où la souris de l'utilisateur entre ou sort d'un élément GUI. Par conséquent, les arguments `x` et `y` peuvent ne pas correspondre parfaitement aux coordonnées des bords du GUI.

##### Voir Aussi

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseWheelForward`
- `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseMoved

Se déclenche chaque fois qu'un utilisateur déplace sa souris alors qu'elle est à l'intérieur d'un élément GUI.

L'événement WheelBackward se déclenche lorsqu'un utilisateur fait défiler sa souris en arrière lorsqu'elle est sur un élément `Class.GuiObject`. C'est similaire à `Class.Mouse.WheelBackward`, qui se déclenche indépendamment de si la souris de l'utilisateur est sur un élément GUI.

Cet événement se déclenche simplement comme un indicateur du mouvement en arrière de la roue. Cela signifie que les arguments de coordonnées de souris `x` et `y` ne changent pas à la suite de cet événement. Ces coordonnées ne changent que lorsque la souris se déplace, ce qui peut être suivi par l'événement `Class.GuiObject.MouseMoved`.

##### Voir Aussi

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelForward`

GuiObject.MouseWheelBackward

Se déclenche lorsqu'un utilisateur fait défiler sa souris en arrière alors que la souris est sur un élément GUI.

L'événement WheelForward se déclenche lorsqu'un utilisateur fait défiler sa souris en avant lorsqu'elle est sur un élément `Class.GuiObject`. C'est similaire à `Class.Mouse.WheelForward`, qui se déclenche indépendamment de si la souris de l'utilisateur est sur un élément GUI.

Cet événement se déclenche simplement comme un indicateur du mouvement vers l'avant de la roue. Cela signifie que les coordonnées de souris **X** et **Y** ne changent pas à la suite de cet événement. Ces coordonnées ne changent que lorsque la souris se déplace, ce qui peut être suivi par l'événement `Class.GuiObject.MouseMoved`.

##### Voir Aussi

- `Class.GuiObject.MouseEnter`
- `Class.GuiObject.MouseLeave`
- `Class.GuiObject.MouseMoved`
- `Class.GuiObject.MouseWheelBackward`

GuiObject.MouseWheelForward

La coordonnée **Y** de la souris de l'utilisateur.

Se déclenche lorsqu'un utilisateur fait défiler sa souris en avant alors que la souris est sur un élément GUI.

L'exemple suivant affiche un message lorsque l'utilisateur sélectionne l'objet avec un
manette.

Pour que cela fonctionne comme prévu, il doit être placé dans un `LocalScript`
et un enfant de _gui_.

Cet événement se déclenche lorsque le sélecteur de la manette de jeu commence à se concentrer sur le `Class.GuiObject`.

Si vous souhaitez vérifier quand le sélecteur de la manette cesse de se concentrer sur l'élément GUI, vous pouvez utiliser l'événement `Class.GuiObject.SelectionLost`.

Lorsque un GUI acquiert la concentration de sélection, la valeur de la propriété `Class.GuiService.SelectedObject|SelectedObject` change également vers celui qui acquiert la sélection. Pour déterminer quel GUI a acquis la sélection, vérifiez la valeur de cette propriété.

GuiObject.SelectionGained

Déclenché lorsque le GuiObject est mis au point avec le sélecteur de la manette de jeu.

L'exemple suivant affiche un message lorsque l'élément perd son focus sur
une manette.

Pour que cela fonctionne comme prévu, il doit être placé dans un `LocalScript`
et être un enfant de _gui_.

Cet événement se déclenche lorsque le sélecteur de la manette de jeu cesse de se concentrer sur le `Class.GuiObject`.

Si vous souhaitez vérifier quand le sélecteur de la manette commence à se concentrer sur l'élément GUI, vous pouvez utiliser l'événement `Class.GuiObject.SelectionGained`.

Lorsque un GUI perd la concentration de sélection, la valeur de la propriété `Class.GuiService.SelectionObject|SelectionObject` change soit vers `nil` soit vers l'élément GUI qui acquiert la concentration de sélection. Pour déterminer quel GUI a acquis la sélection, ou si aucun GUI n'est sélectionné, vérifiez la valeur de cette propriété.

GuiObject.SelectionLost

Déclenché lorsque le sélecteur de la manette de jeu cesse de se concentrer sur le GuiObject.

Cet exemple de code permet au joueur de manipuler la position à l'écran de certains
éléments UI, comme un `Frame`, en maintenant l'élément UI pendant un court
instant. Ensuite, le joueur déplace son doigt et relâche. Pendant le geste,
le Frame est coloré en bleu avec un contour blanc.

Cet événement se déclenche après un bref moment lorsque le joueur maintient son doigt
sur l'élément de l'interface utilisateur en utilisant un appareil tactile. Il se déclenche avec une table de
`Datatype.Vector2` qui décrit les positions d'écran relatives des
doigts impliqués dans le geste. De plus, il se déclenche plusieurs fois :
`Enum.UserInputState.Begin` après un court délai,
`Enum.UserInputState.Change` si le joueur déplace son doigt pendant le
geste, et enfin `Enum.UserInputState.End`. Le délai dépend de la plateforme ; dans Studio, il est un peu plus long qu'une seconde.

GuiObject.TouchLongPress

touchPositions

Un tableau de `Datatype.Vector2` qui décrit les positions **relatives** des doigts impliqués dans le geste.

state

Un `Enum.UserInputState` qui décrit l'état du geste :

- Begin se déclenche une fois au début du geste (après le bref délai)
- Change se déclenche si le joueur déplace son doigt tout en appuyant
- End se déclenche une fois à la fin du geste lorsque le joueur relâche son doigt.

Déclenché lorsque le joueur commence, continue et arrête de faire un appui long sur l'élément de l'UI.

Cet exemple de code est destiné à être placé dans un `LocalScript` à l'intérieur d'un
`Frame` qui est à l'intérieur d'un `Frame` extérieur, ou d'un autre `GuiObject`. Il permet au
joueur de manipuler la position du cadre intérieur en déplaçant son doigt sur
le cadre extérieur.

Cet événement se déclenche lorsque le joueur déplace son doigt sur l'élément de l'interface utilisateur
en utilisant un appareil tactile. Il se déclenche peu avant
`Class.GuiObject.TouchSwipe`, et ne se déclenche pas avec
`Class.GuiObject.TouchTap`. Cet événement est utile pour permettre au joueur
de manipuler la position des éléments de l'interface utilisateur à l'écran.

Cet événement se déclenche avec une table de `Datatype.Vector2` qui décrit les
positions d'écran relatives des doigts impliqués dans le geste. De
plus, il se déclenche plusieurs fois : `Enum.UserInputState.Begin` après un
court délai, `Enum.UserInputState.Change` lorsque le joueur déplace son
doigt pendant le geste, et enfin avec `Enum.UserInputState.End`.

GuiObject.TouchPan

Un tableau Luau d'objets `Datatype.Vector2`, chacun indiquant la position de tous les doigts impliqués dans le geste.

totalTranslation

Indique à quel point le geste de panoramique a progressé par rapport à son point de départ.

velocity

Indique à quelle vitesse le geste est effectué dans chaque dimension.

Indique l'`Enum.UserInputState` du geste.

Déclenché lorsque le joueur déplace son doigt sur l'élément UI.

Cet exemple de code est destiné à un `LocalScript` à l'intérieur d'un `Frame` intérieur qui est
à l'intérieur d'un `Frame` extérieur, ou d'un autre `GuiObject`. Il permet au joueur de redimensionner
le cadre intérieur en effectuant un geste de `Class.GuiObject.TouchPinch` sur le
cadre extérieur.

Cet événement se déclenche lorsque le joueur utilise deux doigts pour effectuer un geste de pincement ou de tirage
sur l'élément de l'interface utilisateur en utilisant un appareil tactile. Un **pincement**
se produit lorsque deux doigts ou plus se rapprochent, et un **tirage**
se produit lorsqu'ils s'éloignent. Cet événement se déclenche en conjonction avec
`Class.GuiObject.TouchPan`. Cet événement est utile pour permettre au joueur
de manipuler l'échelle (taille) des éléments de l'interface utilisateur à l'écran, et est le plus
souvent utilisé pour les fonctions de zoom.

Cet événement se déclenche avec une table de `Datatype.Vector2` qui décrit les
positions d'écran relatives des doigts impliqués dans le geste. De
plus, il se déclenche plusieurs fois : `Enum.UserInputState.Begin` après un
court délai, `Enum.UserInputState.Change` lorsque le joueur déplace un doigt
durant le geste, et enfin avec `Enum.UserInputState.End`. Il convient de
noter que l'échelle doit être utilisée **multiplicativement**.

GuiObject.TouchPinch

Un tableau Luau d'objets `Datatype.Vector2`, chacun indiquant la position de tous les doigts impliqués dans le geste de pincement.

scale

Un flottant qui indique la différence par rapport au début du geste de pincement.

Un flottant indiquant à quelle vitesse le geste de pincement s'effectue.

Déclenché lorsque le joueur effectue un geste de pincement ou de tirage avec deux doigts sur l'élément de l'UI.

Cet exemple de code est destiné à un `LocalScript` à l'intérieur d'un `Frame`
qui est à l'intérieur d'un `Frame` extérieur, ou d'un autre `GuiObject`. Il permet au joueur de
faire pivoter le cadre intérieur en effectuant un geste `Class.GuiObject.TouchRotate`
sur le cadre extérieur.

Cet événement se déclenche lorsque le joueur utilise deux doigts pour effectuer un geste de pincement ou de tirage
sur l'élément de l'interface utilisateur en utilisant un appareil tactile. La rotation se produit
lorsque l'angle de la ligne entre deux doigts change. Cet événement se déclenche
en conjonction avec `Class.GuiObject.TouchPan`. Cet événement est utile pour
permettre au joueur de manipuler la rotation des éléments de l'interface utilisateur à l'écran.

Cet événement se déclenche avec une table de `Datatype.Vector2` qui décrit les
positions d'écran relatives des doigts impliqués dans le geste. De
plus, il se déclenche plusieurs fois : `Enum.UserInputState.Begin` après un
court délai, `Enum.UserInputState.Change` lorsque le joueur déplace un doigt
durant le geste, et enfin avec `Enum.UserInputState.End`.

GuiObject.TouchRotate

rotation

Un flottant indiquant à quel point la rotation a progressé depuis le début du geste.

Un flottant qui indique à quelle vitesse le geste est effectué.

Se déclenche lorsque le joueur effectue un geste de rotation avec deux doigts sur l'élément UI.

Cet exemple de code fera rebondir un `Frame` (ou autre `GuiObject`) lorsqu'un geste de
balayage est effectué sur un appareil compatible tactile (ou l'émulateur de Studio).
Les balayages horizontaux changeront la teinte de la
`Class.GuiObject.BackgroundColor3`, tandis que les balayages verticaux changeront la
saturation.

Cet événement se déclenche lorsque le joueur effectue un geste de glissement sur l'élément de l'interface
utilisateur en utilisant un appareil tactile. Il se déclenche avec la direction du
geste (Haut, Bas, Gauche ou Droite) et le nombre de points de contact impliqués
dans le geste. Les gestes de glissement sont souvent utilisés pour changer d'onglets dans les
iU mobiles.

GuiObject.TouchSwipe

swipeDirection

Un `Enum.SwipeDirection` indiquant la direction du geste de balayage (Haut, Bas, Gauche ou Droit).

numberOfTouches

Le nombre de points de contact impliqués dans le geste (généralement 1).

Se déclenche lorsque le joueur effectue un geste de balayage sur l'élément UI.

Cet exemple de code permet d'activer/désactiver la `Class.GuiObject.BackgroundTransparency` d'un
élément UI, comme un `Frame`, lorsqu'il est touché sur un appareil à écran tactile.

Cet événement se déclenche lorsque le joueur effectue un geste de tapotement sur l'élément de l'interface
utilisateur en utilisant un appareil tactile. Un tapotement est un contact unique rapide sans aucun
mouvement impliqué (une pression plus longue déclencherait
`Class.GuiObject.TouchLongPress`, et se déplacer pendant le contact déclencherait
`Class.GuiObject.TouchPan` et/ou `Class.GuiObject.TouchSwipe`). Cela se déclenche
avec une table d'objets `Datatype.Vector2` qui décrivent les positions relatives
des doigts impliqués dans le geste.

GuiObject.TouchTap

Un tableau de `Datatype.Vector2` qui décrit les **positions** relatives des doigts impliqués dans le geste.

Se déclenche lorsque le joueur effectue un geste de tap sur l'élément UI.

Cet échantillon de code démontre une utilisation plus impliquée de TweenPosition en
détectant quand le tween est terminé/annulé en définissant une fonction de rappel. Il
imprime également si le tween va jouer.

Déplace en douceur un GUI vers une nouvelle position `Datatype.UDim2` dans le temps spécifié en utilisant la direction et le style d'adoucissement spécifiés `Enum.EasingDirection` et `Enum.EasingStyle`.

Cette fonction renverra si le tween jouera. Il ne jouera pas si un autre tween agit sur le `Class.GuiObject` et que le paramètre override est `false`.

Voir aussi `Class.GuiObject:TweenSize()` et `Class.GuiObject:TweenSizeAndPosition()`.

GuiObject:TweenPosition

endPosition

easingDirection

La direction dans laquelle adoucir le GUI vers le _endPosition_.

easingStyle

Le style dans lequel adoucir le GUI vers le _endPosition_.

time

Combien de temps, en secondes, le tween devrait prendre pour se terminer.

override

Que le tween va remplacer un tween en cours.

callback

Une fonction de rappel à exécuter lorsque le tween est terminé.

Déplace en douceur un GUI vers un nouveau `Datatype.UDim2`.

Cet exemple de code démontre l'utilisation de la fonction `Class.GuiObject:TweenSize()`
. Il initie une animation sur la propriété `Class.GuiObject.Size`
du parent pour passer à `UDim2.new(0.5, 0, 0.5, 0)`, ce qui représente la moitié de la
taille d'un `GuiObject` du parent sur les deux axes.

De plus, il démontre comment le paramètre de rappel peut être utilisé pour détecter
quand l'animation s'arrête (qu'elle ait été annulée par une autre animation ou qu'elle soit terminée).

Redimensionne en douceur un `Class.GuiObject` à un nouveau `Datatype.UDim2` dans le temps spécifié en utilisant la direction et le style d'adoucissement spécifiés `Enum.EasingDirection` et `Enum.EasingStyle`.

Cette fonction renverra si le tween va jouer. Normalement, cela renverra toujours `true`, mais cela renverra `false` si un autre tween est actif et que override est défini sur `false`.

Voir aussi `Class.GuiObject:TweenSize()` et `Class.GuiObject:TweenSizeAndPosition()`.

GuiObject:TweenSize

endSize

La taille que le GUI devrait redimensionner.

La direction dans laquelle adoucir le GUI vers le _endSize_.

Le style dans lequel adoucir le GUI vers le _endSize_.

Redimensionne en douceur un `Class.GuiObject` à un nouveau `Datatype.UDim2`.

L'exemple ci-dessous animerait un `Class.Frame` vers le coin supérieur gauche de la taille du parent
et le redimensionnerait à 0.

Redimensionne et déplace en douceur un GUI vers une nouvelle taille `Datatype.UDim2` et position dans le temps spécifié en utilisant la direction et le style d'adoucissement spécifiés `Enum.EasingDirection` et `Enum.EasingStyle`.

Cette fonction renverra si le tween jouera. Normalement, cela renverra toujours `true`, mais cela renverra `false` si un autre tween est actif et que override est défini sur `false`.

Voir aussi `Class.GuiObject:TweenSize()` et `Class.GuiObject:TweenSizeAndPosition()`.

GuiObject:TweenSizeAndPosition

La direction dans laquelle adoucir le GUI vers le _endSize_ et _endPosition_.

Le style dans lequel adoucir le GUI vers le _endSize_ et _endPosition_.

Déplace en douceur un GUI vers une nouvelle taille et position.

GuiObject

Cet exemple de code démontre l'utilisation de la propriété Active comme un debounce
pour l'événement Activated.

Cette propriété détermine si le `Class.GuiObject` absorbe l'entrée dans l'espace 3D, comme des modèles sous-jacents avec une classe `Class.ClickDetector` comme `Class.DragDetector`.

Pour les objets `Class.GuiButton` (`Class.ImageButton` et `Class.TextButton`), cette propriété détermine si `Class.GuiButton.Activated|Activated` est déclenché (`Class.GuiButton.AutoButtonColor|AutoButtonColor` fonctionnera toujours pour ceux-ci également). Les événements `Class.GuiObject.InputBegan|InputBegan`, `Class.GuiObject.InputChanged|InputChanged`, et `Class.GuiObject.InputEnded|InputEnded` fonctionnent normalement, quelle que soit la valeur de cette propriété.

GuiObject.Active

Détermine si cet élément UI absorbe l'entrée.

Cet exemple de code déplace un élément UI vers différents côtés de l'élément parent.
Il commence en haut à gauche et se termine en bas à droite. Collez dans un
LocalScript dans un Frame, au sein d'un ScreenGui.

Cette propriété détermine le point d'origine d'un `Class.GuiObject`, par rapport à sa taille absolue. Le point d'origine détermine d'où l'élément est positionné (via `Class.GuiObject.Position`) et à partir duquel la `Class.GuiObject.Size` rendue s'étend.

Voir [ici](/ui/position-and-size#anchorpoint) pour des diagrammes illustrés et des détails.

GuiObject.AnchorPoint

Détermine le point d'origine d'un `Class.GuiObject`, par rapport à sa taille absolue.

Le script suivant crée un cadre parent à taille automatique avec
un `UIListLayout`, puis il insère plusieurs objets `TextLabel` à taille automatique.
Notez comment le `UIListLayout` parent redimensionne automatiquement pour s'adapter à
son contenu enfant et les étiquettes redimensionnent automatiquement pour s'adapter à leur contenu textuel.
Ce script peut être parenté à un `ScreenGui`.

Cette propriété est utilisée pour redimensionner automatiquement les objets UI parents en fonction de la taille de leurs descendants. Vous pouvez utiliser cette propriété pour ajouter dynamiquement du texte et d'autres contenus à un objet UI au moment de l'édition ou d'exécution, et la taille s'ajustera pour s'adapter à ce contenu.

Lorsque `Class.GuiObject.AutomaticSize|AutomaticSize` est défini sur une valeur `Enum.AutomaticSize` autre que `Enum.AutomaticSize|None`, cet objet UI peut redimensionner en fonction de son contenu enfant.

Pour plus d'informations sur la façon d'utiliser cette propriété et sur son fonctionnement, veuillez voir [ici](/ui/size-modifiers#automatic-sizing).

GuiObject.AutomaticSize

Détermine si le redimensionnement se fait en fonction du contenu enfant.

Détermine la couleur de l'arrière-plan du `Class.GuiObject`.

GuiObject.BackgroundColor

Cet exemple de code fait en sorte qu'un cadre parent boucle à travers toutes les couleurs de l'
arc-en-ciel en utilisant Color3.fromHSV.

Cette propriété détermine la couleur de l'arrière-plan d'un `Class.GuiObject` (la couleur de remplissage). Si votre élément contient du texte, tel qu'un `Class.TextBox`, `Class.TextButton`, ou `Class.TextLabel`, assurez-vous que la couleur de votre arrière-plan contraste avec la couleur du texte.

Une autre propriété qui détermine les propriétés visuelles de l'arrière-plan est `Class.GuiObject.BackgroundTransparency`; si celle-ci est définie sur `1`, ni l'arrière-plan ni la bordure ne seront rendus.

Voir aussi `Class.GuiObject.BorderColor3|BorderColor3`.

GuiObject.BackgroundColor3

Détermine la couleur d'arrière-plan du `Class.GuiObject`.

Cette propriété détermine la transparence de l'arrière-plan et de la bordure du `Class.GuiObject`. Cependant, elle ne détermine pas la transparence du texte si le GUI est un `Class.TextBox`, `Class.TextButton`, ou `Class.TextLabel`; la transparence du texte est déterminée par `Class.TextBox.TextTransparency`, `Class.TextButton.TextTransparency`, et `Class.TextLabel.TextTransparency` respectivement.

Si cette propriété est définie sur `1`, ni l'arrière-plan ni la bordure ne seront rendus et l'arrière-plan du GUI sera complètement transparent.

GuiObject.BackgroundTransparency

Détermine la transparence de l'arrière-plan et de la bordure du `Class.GuiObject`.

Détermine la couleur de la bordure du `Class.GuiObject`.

GuiObject.BorderColor

Cet exemple de code fait en sorte que la bordure d'un GuiObject parent soit mise en surbrillance lorsque
l'utilisateur survole l'élément avec sa souris.

Détermine la couleur de la bordure rectangulaire du `Class.GuiObject` (également connue sous le nom de couleur de trait). Cela est séparé de la couleur d'arrière-plan de l'objet `Class.GuiObject.BackgroundColor3`. Vous ne pourrez pas voir la bordure de l'objet si sa propriété `Class.GuiObject.BorderSizePixel` est définie sur `0`.

Notez que le composant `Class.UIStroke` permet des effets de bordure plus avancés.

GuiObject.BorderColor3

Une classe abstraite pour tous les objets d'interface utilisateur 2D.