GuiButton
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
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
Détermine si le bouton change automatiquement de couleur lorsque la souris survole ou clique dessus.
Une instance HapticEffect qui jouera lorsque le GuiButton sera survolé.
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é.
Une instance HapticEffect qui jouera lorsque le GuiButton sera appuyé.
Une propriété booléenne qui indique si l'objet a été sélectionné.
Définit le style du GuiButton en fonction d'une liste de styles prédéterminés.
Détermine si cet élément d'interface utilisateur coule l'entrée.
Détermine le point d'origine d'un GuiObject , par rapport à sa taille absolue.
Détermine si la redimensionisation se produit en fonction du contenu de l'enfant.
Détermine la couleur de fond GuiObject.
Détermine la transparence du fond et des bords GuiObject.
Détermine la couleur de la bordure GuiObject.
Détermine de quelle manière la bordure GuiObject est disposée par rapport à ses dimensions.
Détermine la largeur des pixels de la bordure GuiObject.
Détermine si le descendant GuiObjects en dehors des limites d'un élément GUI parent doit s'rendu.
Détermine si la souris du joueur est activement pressée sur le GuiObject ou non.
Détermine si la GuiButton peut être interagie ou non, ou si la GuiState du GuiObject change ou non.
Contrôle l'ordre de tri des GuiObject lorsqu'ils sont utilisés avec un UIGridStyleLayout .
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de manette sera déplacé vers le bas.
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de manette sera déplacé à gauche.
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de manette sera déplacé à droite.
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de manette sera déplacé vers le haut.
Détermine la position pixelaire et vectorielle du GuiObject .
Détermine le nombre de degrés par lesquels le GuiObject est pivoté.
Déterminez si le GuiObject peut être sélectionné par une manette de jeu.
Annule la décoration de sélection par défaut utilisée pour les gamepads.
L'ordre de GuiObjects sélectionné par la sélection de l'interface de jeu.
Détermine la taille des pixels et des échelles du GuiObject .
Définit les axes Size sur lesquels la GuiObject sera basée, par rapport à la taille de son parent.
Une propriété mixée de BackgroundTransparency et TextTransparency.
Détermine si le GuiObject et ses descendants seront rendus.
Détermine l'ordre dans lequel un GuiObject rendu se rapporte aux autres.
Décrit la position réelle d'un élément GuiBase2d sur l'écran, en pixels.
Décrit la rotation réelle de l'écran d'un élément GuiBase2d en degrés.
Décrit la taille réelle de l'écran d'un élément GuiBase2d, en pixels.
Lorsqu'il est défini à true, la localisation sera appliquée à ce GuiBase2d et à ses descendants.
Une référence à un LocalizationTable à utiliser pour appliquer une localisation automatisée à ce GuiBase2d et à ses descendants.
Personnalise le comportement de sélection du manette de jeu dans la direction descendante.
Personnalise le comportement de sélection du manette de jeu dans la direction de gauche.
Personnalise le comportement de sélection du gamepad dans la bonne direction.
Personnalise le comportement de sélection du gamepad dans la direction vers le haut.
Permet la personnalisation du mouvement de sélection du gamepad.
Méthodes
Méthodes hérités de GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Déplace doucement une GUI vers une nouvelle UDim2.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Redimensionne sans problème un GuiObject à un nouveau UDim2.
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Déplace doucement une interface graphique à une nouvelle taille et position.
Évènements
Se déclenche lorsque le bouton est activé.
S'enflamme lorsque la souris de l'utilisateur clique pleinement sur le GuiButton.
S'enflamme lorsque l'utilisateur appuie sur le bouton de souris gauche vers le bas sur le GuiButton.
Se déclenche lorsque l'utilisateur relâche le bouton de souris gauche du GuiButton .
S'enflamme lorsque la souris de l'utilisateur clique pleinement avec le bouton droit sur le GuiButton.
S'enflamme lorsque l'utilisateur appuie sur le bouton droit de sa souris vers le bas sur le GuiButton.
S'enflamme lorsque l'utilisateur relâche le bouton droit de la souris hors de la GuiButton.
Tiré lorsqu'un utilisateur commence à interagir via un appareil d'interface humain-ordinateur (bouton de souris vers le bas, toucher début, bouton de clavier vers le bas, etc).
Tiré lorsqu'un utilisateur modifie la façon dont il interagit via un appareil d'interface homme-ordinateur (bouton de souris vers le bas, toucher début, bouton de clavier vers le bas, etc.).
Tiré lorsqu'un utilisateur cesse d'interagir via un appareil d'interface humain-ordinateur (bouton de souris vers le bas, toucher début, bouton du clavier vers le bas, etc).
Se déclenche lorsqu'un utilisateur déplace sa souris dans un élément GUI.
Se déclenche lorsqu'un utilisateur déplace sa souris en dehors d'un élément GUI.
Se déclenche chaque fois qu'un utilisateur déplace sa souris alors qu'elle se trouve à l'intérieur d'un élément GUI.
Se déclenche lorsqu'un utilisateur fait défiler la molette de sa souris en arrière lorsque la souris se trouve sur un élément de l'interface graphique.
Se déclenche lorsqu'un utilisateur fait défiler sa molette de souris vers l'avant lorsque la souris se trouve sur un élément de l'interface graphique.
Tiré lorsque l'objet Gui est mis en évidence avec le sélecteur de manette.
Tiré lorsque le sélecteur de manette arrête de se concentrer sur l'objet Gui.
Se déclenche lorsque le joueur commence, continue et s'arrête en appuyant longuement sur l'élément d'interface utilisateur.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Se déclenche lorsque le joueur déplace son doigt sur l'élément d'interface utilisateur.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Se déclenche lorsque le joueur effectue une gestuelle de pinçage ou de tirage à l'aide de deux doigts sur l'élément d'interface.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Se déclenche lorsque le joueur effectue une gestuelle de rotation à l'aide de deux doigts sur l'élément d'interface utilisateur.
Se déclenche lorsque le joueur effectue une gestuelle de glissement sur l'élément d'interface utilisateur.
S'enflamme lorsque le joueur effectue une gestuelle de tap sur l'élément d'interface.
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Se déclenche lorsque la sélection de la manette de jeu se déplace, quitte ou change dans le connecteur GuiBase2d ou dans n'importe quel descendant GuiObjects.
Propriétés
AutoButtonColor
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 .
Modal
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é.
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
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.