GuiButton

Afficher les obsolètes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Création impossible
Non navigable

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

L'événement le plus important d'un GuiButton est 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 avec le curseur toujours sur l'objet d'interface utilisateur.Pour la touche, c'est la même chose, mais avec une touche au lieu d'une appuyerde bouton.Enfin, pour les manettes, Activated tire si une GuiButton est sélectionnée lorsque le bouton A est pressé et relâché.En bref, cet événement est très utile pour la programmation de l'interface utilisateur mult平台 car il fournit une belle interface générale pour une seule entrée de l'utilisateur.

Résumé

Propriétés

Propriétés hérités de GuiObjectPropriétés hérités de GuiBase2d

Méthodes

Méthodes hérités de GuiObject

Évènements

Évènements hérités de GuiObjectÉvènements hérités de GuiBase2d

Propriétés

AutoButtonColor

Lecture parallèle

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

Si vous souhaitez personnaliser la façon dont un bouton change lorsque la souris de l'utilisateur survole ou clique dessus, envisagez d'utiliser un ImageButton et de modifier l'élément HoverImage et PressedImage.

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

HoverHapticEffect

Lecture parallèle

Une instance HapticEffect qui jouera lorsque le GuiButton sera survolé.

Lecture parallèle

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

PressHapticEffect

Lecture parallèle

Une instance HapticEffect qui jouera lorsque le GuiButton sera appuyé.

Selected

Lecture parallèle

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

Lecture parallèle

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

Méthodes

Évènements

Activated

Se déclenche lorsque le bouton est activé.Comme cet événement ne se déclenche pas sur le serveur, il ne devrait être utilisé qu'en LocalScript , ou dans un Script avec RunContext de Enum.RunContext.Client .

Paramètres

inputObject: InputObject
clickCount: number

MouseButton1Click

Cet événement se déclenche lorsque la souris de l'utilisateur clique pleinement sur le GuiButton.

En ce qui concerne le clic, la souris doit être dans les limites du GuiButton et le bouton de la souris doit être pressé vers le bas et vers le haut avant que cet événement ne se déclenche.Si la souris quitte les limites du GuiButton et est libérée, l'événement ne se déclenchera pas.Si vous souhaitez éviter cette limitation, vous pouvez utiliser MouseButton1Down et MouseButton1Up ; ces événements sont similaires mais se déclencheront chaque fois que l'utilisateur appuiera sur le bouton de souris gauche ou sur le bouton de souris supérieur, respectivement.


MouseButton1Down

Cet événement se déclenche lorsque l'utilisateur appuie sur le bouton de souris gauche en bas sur le GuiButton.

Pour un événement nécessitant que l'utilisateur appuie sur et pour libérer sa souris gauche sur un GuiButton afin que l'événement se lancer, envisagez d'utiliser MouseButton1Click .

Paramètres

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

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


MouseButton1Up

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

Pour un événement nécessitant que l'utilisateur appuie sur et pour libérer sa souris gauche sur un GuiButton afin que l'événement se lancer, envisagez d'utiliser MouseButton1Click .

Paramètres

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

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


MouseButton2Click

Cet événement se déclenche lorsque la souris de l'utilisateur fait un clic droit complet sur le GuiButton.

En ce qui concerne le clic, la souris doit être dans les limites du GuiButton et le bouton de la souris doit être pressé vers le bas et vers le haut avant que cet événement ne se déclenche.Si la souris quitte les limites du GuiButton et est libérée, l'événement ne se déclenchera pas.Si vous souhaitez éviter cette limitation, vous pouvez utiliser MouseButton2Down et MouseButton2Up ; ces événements sont similaires mais se déclencheront chaque fois que l'utilisateur appuiera sur le bouton droit de la souris ou le bouton supérieur de la souris, respectivement.


MouseButton2Down

Cet événement se déclenche lorsque l'utilisateur appuie sur le bouton droit de sa souris en bas sur le GuiButton.

Pour un événement nécessitant que l'utilisateur appuie sur et pour libérer leur souris droite sur un GuiButton afin que l'événement se lancer, envisagez d'utiliser MouseButton2Click .

Paramètres

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

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


MouseButton2Up

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

Pour un événement nécessitant que l'utilisateur appuie sur et pour libérer leur souris droite sur un GuiButton afin que l'événement se lancer, envisagez d'utiliser MouseButton2Click .

Paramètres

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

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