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. Il s'agit de l'interface utilisateur de base pour ImageButton et <
L'événement le plus important d'un GuiButton est GuiButton.Activated, un événement multi-plateforme qui se déclenche lorsque le bouton est activé. Lors de l'utilisation d'une souris, cela signifie
Résumé
Propriétés
Détermine si le bouton change automatiquement de couleur lorsque la souris s'arrête dessus ou clique dessus.
Si oui, l'élément GUI est visible, la souris ne sera pas verrouillée à moins que le bouton de souris droit ne soit vers le bas.
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éfinis.
Détermine si cet élément de l'interface utilisateur coule l'entrée.
Détermine le point d'origine d'un GuiObject , par rapport à sa taille absolue.
Détermine si la redimensionnement se produit en fonction du contenu de l'enfant.
Détermine la couleur de l'arrière-plan GuiObject.
Détermine la transparence de l'arrière-plan et de la frontière de GuiObject.
Détermine la couleur de la GuiObject bordure.
Détermine la manière dont la GuiObject bordure est distribuée par rapport à ses dimensions.
Détermine la largeur de pixel de la GuiObject bordure.
Détermine si le descendant GuiObjects en dehors des limites d'un élément GUI parent doit rendu.
Détermine si la souris du joueur est activement pressée sur le GuiObject ou non.
Détermine si le GuiButton peut être interagi ou non, ou si le GuiState du GuiObject change ou non.
Contrôle l'ordre de tri du GuiObject lorsqu'il est utilisé avec un UIGridStyleLayout .
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de gamepad sera déplacé vers le bas.
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de gamepad sera déplacé à gauche.
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de gamepad sera déplacé à droite.
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de gamepad sera déplacé vers le haut.
Détermine la position pixel et vectorielle de l' GuiObject .
Détermine le nombre de degrés par lesquels le GuiObject est pivoté.
Déterminez si le GUI peut être sélectionné par une manette de jeu.
Surclasse l'ornement de sélection par défaut utilisé pour les gamepads.
L'ordre de GuiObjects sélectionné par la sélection de l'interface de jeu.
Détermine la taille de pixel et de taille vectorielle de GuiObject .
Définit les Size axes sur lesquels le GuiObject sera basé, par rapport à la taille de son parent.
Une propriété mixte de BackgroundTransparency et TextTransparency .
Détermine si le GuiObject et ses descendants seront rendus.
Détermine l'ordre dans lequel un GuiObject rendu par rapport aux autres.
Décrivez la position d'écran réelle d'un élément UI, en pixels.
Décrivez la rotation de l'écran réelle d'un élément UI, en degrés.
Décrivez la taille réelle de l'interface utilisateur, en pixels.
Lorsqu'il est réglé sur vrai, la localisation sera appliquée à ce GuiBase2d et à ses descendants.
Une référence à un LocalizationTable pour être utilisé pour appliquer la localisation automatisée à ce GuiBase2d et à ses descendants.
Personnalise le comportement de sélection du gamepad dans la direction vers le bas.
Personnalise le comportement de sélection du gamepad 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 de la 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 : bool,callback : function):bool
Déplace facilement une GUI vers un nouveau UDim2.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Redimensionne facilement une GUI en une nouvelle UDim2 .
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Déplace facilement une GUI dans une nouvelle taille et position.
Évènements
Se déclenche lorsque le bouton est activé.
Tiré lorsque la souris a complètement quitté de cliquer sur le bouton de l'interface graphique.
Activé lorsque la souris est dans l'état de la souris vers le bas de gauche sur l'objet GUI.
Lancement lorsque la souris gauche a libéré l'objet GUI.
Tiré lorsque la souris a cliqué entièrement sur le bouton de l'interface graphique.
Activé lorsque la souris est dans l'état de la souris en bas à droite sur l'objet GUI.
Lancement lorsque le bouton droit de la souris a été relâché sur un objet GUI.
Activé lorsqu'un utilisateur commence à interagir via un appareil d'interface humain-ordinateur (bouton de souris, toucher de début, bouton de clavier, etc).
Activé lorsqu'un utilisateur change la façon dont ils interagissent via un appareil d'interface humain-ordinateur (bouton de souris, toucher le début, bouton de clavier, etc).
Activé lorsqu'un utilisateur arrête d'interagir via un appareil d'interface humain-ordinateur (bouton de souris, toucher début, bouton de clavier, etc).
Se déclenche lorsqu'un utilisateur déplace son curseur dans un élément GUI.
Se déclenche lorsqu'un utilisateur déplace sa souris à l'extérieur d'un élément GUI.
Se déclenche toujours lorsqu'un utilisateur déplace sa souris pendant qu'il est à l'intérieur d'un élément GUI.
Se déclenche lorsqu'un utilisateur fait glisser son roue de souris quand la souris est sur un élément de l'interface graphique.
Se déclenche lorsqu'un utilisateur fait glisser sa molette de souris vers l'avant lorsqu'il est au-dessus d'un élément GUI.
Activé lorsque l'objet Gui est focalisé avec le sélecteur Gamepad.
Activé lorsque le sélecteur Gamepad arrête de se concentrer sur GuiObject.
Démarre lorsque le joueur démarre, continue et s'arrête longuement sur la pression de l'API.
- 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 de l'interface utilisateur.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Se déclenche lorsque le joueur effectue un geste de pince ou de tir à l'aide de deux doigts sur l'élément de l'interface utilisateur.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Se déclenche lorsque le joueur effectue une rotation à l'aide de deux doigts sur l'élément de l'interface utilisateur.
Se déclenche lorsque le joueur effectue un geste de ramassage sur l'élément de l'interface utilisateur.
Se déclenche lorsque le joueur effectue un geste de touche sur l'élément de l'interface.
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Se déclenche lorsque la sélection du gamepad se déplace, quitte ou change dans la GuiBase2d ou tout descendant GuiObjects connecté.
Propriétés
AutoButtonColor
La couleur bouton automatique détermine si le bouton change automatiquement de couleur lorsque la souris de l'utilisateur Mouse passe dessus ou clique dessus.
Si oui, le bouton changera automatiquement de couleur lorsque la souris s'abat dessus ou clique dessus. Si non, le bouton ne changera pas.
Si vous souhaitez personnaliser la façon dont un bouton change lorsque la souris de l'utilisateur passe dessus ou clique dessus, considérez l'utilisation d'une ImageButton GUI et modifiez la ImageButton.HoverImage et ImageButton.PressedImage de l'élément.
Veuillez noter que cette propriété n'aura aucun effet sur un ImageButton si sa valeur est définie sur une image et n'est pas nulle. De plus, la propriété n'affectera pas un élément ImageButton lors de la souris sur le clic lorsque sa valeur est définie sur une image et n'est pas nulle ni sur la souris clique lorsque
Échantillons de code
local button = script.Parent
if button:IsA("ImageButton") then
if button.HoverImage and button.ClickImage then
return
end
end
button.AutoButtonColor = trueModal
Si oui, l'élément GUI est visible, la souris ne sera pas verrouillée à moins que le bouton de souris droit ne soit vers le bas.
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' dans un LocalScript , ou dans un Script avec RunContext de 2>Class.Script.Run2> .
Paramètres
MouseButton1Click
L'événement MouseButton1Click se déclenche lorsque le bouton de souris de l'utilisateur clique entièrement sur le bouton GUI.
En cliquant, la souris doit être dans les limites du bouton et doit être pressée vers le bas et vers le haut à nouveau avant que cet événement se déclenche. Si la souris quitte les limites du bouton et est libérée, cet événement ne se lancerpas. Si vous souhaitez éviter cette limite, vous pouvez utiliser GuiButton.MouseButton1Down et MouseButton1Up
Cet événement est similaire à GuiButton.MouseButton2Click, qui se comporte identiquement sauf qu'il est connecté au bouton droit de la souris de l'utilisateur.
Notez que cet événement ne se déclenchera que pour les boutons de GUI, y compris TextButtons et ImageButton. Il ne se déclenchera pas pour d'autres GuiObjects .
Échantillons de code
local button = script.Parent
local function leftClick()
print("Left mouse click")
end
local function rightClick()
print("Right mouse click")
end
button.MouseButton1Click:Connect(leftClick)
button.MouseButton2Click:Connect(rightClick)MouseButton1Down
L'événement MouseButton1Down se déclenche lorsque l'utilisateur appuie sur leur bouton gauche Mouse sur l'objet GUI.
Cet événement est similaire à GuiButton.MouseButton2Down, qui se comporte identiquement sauf qu'il est connecté au bouton droit de la souris de l'utilisateur.
Si vous recherchez un événement nécessitant que l'utilisateur appuie et relâche son clic gauche sur une GUI afin que l'événement se lancer, considérez l'utilisation de GuiButton.MouseButton1Click.
Notez que cet événement ne se déclenchera que pour les boutons de GUI, y compris TextButtons et ImageButton. Il ne se déclenchera pas pour d'autres GuiObjects .
Paramètres
La coordonnée x de l'écran de la souris en pixels.
La coordonnée de l'écran de la souris en pixels.
Échantillons de code
local button = script.Parent
local function leftMouseButtonUp(x, y)
print("Left mouse up at", x, y)
end
local function leftMouseButtonDown(x, y)
print("Left mouse down at", x, y)
end
button.MouseButton1Up:Connect(leftMouseButtonUp)
button.MouseButton1Down:Connect(leftMouseButtonDown)MouseButton1Up
L'événement MouseButton1Up se déclenche lorsque l'utilisateur relâche leur gauche Mouse hors de l'objet GUI.
Cet événement est similaire à GuiButton.MouseButton2Up, qui se comporte identiquement sauf qu'il est connecté au bouton droit de la souris de l'utilisateur.
Si vous recherchez un événement nécessitant que l'utilisateur appuie et relâche son clic gauche sur une GUI afin que l'événement se lancer, considérez l'utilisation de GuiButton.MouseButton1Click.
Notez que cet événement ne se déclenchera que pour les boutons de GUI, y compris TextButtons et ImageButton. Il ne se déclenchera pas pour d'autres GuiObjects .
Paramètres
La coordonnée x de l'écran de la souris en pixels.
La coordonnée de l'écran de la souris en pixels.
Échantillons de code
local button = script.Parent
local function leftMouseButtonUp(x, y)
print("Left mouse up at", x, y)
end
local function leftMouseButtonDown(x, y)
print("Left mouse down at", x, y)
end
button.MouseButton1Up:Connect(leftMouseButtonUp)
button.MouseButton1Down:Connect(leftMouseButtonDown)MouseButton2Click
L'événement MouseButton2Click se déclenche lorsque le bouton droit de l'utilisateur clique entièrement sur le bouton GUI.
En cliquant, la souris doit être dans les limites du bouton et doit être pressée vers le bas et vers le haut à nouveau avant que cet événement se déclenche. Si la souris quitte les limites du bouton et est libérée, cet événement ne se lancerpas. Si vous souhaitez éviter cette limite, vous pouvez utiliser GuiButton.MouseButton2Down et MouseButton2Up
Cet événement est similaire à GuiButton.MouseButton1Click, qui se comporte identiquement sauf qu'il est connecté au bouton de souris gauche de l'utilisateur.
Notez que cet événement ne se déclenchera que pour les boutons de GUI, y compris TextButtons et ImageButton. Il ne se déclenchera pas pour d'autres GuiObjects .
Échantillons de code
local button = script.Parent.Button
local function rightClick()
print("Right click pressed down and up on button.")
end
button.MouseButton2Click:Connect(rightClick)
MouseButton2Down
L'événement MouseButton2Down se déclenche lorsque l'utilisateur appuie sur leur bouton droit Mouse sur l'objet GUI.
Cet événement est similaire à GuiButton.MouseButton1Down, qui se comporte identiquement sauf qu'il est connecté au bouton de souris gauche de l'utilisateur.
Si vous recherchez un événement nécessitant que l'utilisateur appuie et relâche son bouton droit de la souris sur un GUI afin que l'événement se lancer, considérez l'utilisation de GuiButton.MouseButton2Click.
Notez que cet événement ne se déclenchera que pour les boutons de GUI, y compris TextButtons et ImageButton. Il ne se déclenchera pas pour d'autres GuiObjects .
Paramètres
La coordonnée x de l'écran de la souris en pixels.
La coordonnée de l'écran de la souris en pixels.
Échantillons de code
local gui = script.Parent
local button = gui.Button
function rightMouseButtonUp(x, y)
print("Right mouse up", x, y)
end
function rightMouseButtonDown(x, y)
print("Right mouse down", x, y)
end
button.MouseButton2Up:Connect(rightMouseButtonUp)
button.MouseButton2Down:Connect(rightMouseButtonDown)
MouseButton2Up
L'événement MouseButton2Up se déclenche lorsque l'utilisateur relâche leur bouton droit Mouse en dehors de l'objet GUI.
Cet événement est similaire à GuiButton.MouseButton1Up, qui se comporte identiquement sauf qu'il est connecté au bouton de souris gauche de l'utilisateur.
Si vous recherchez un événement nécessitant que l'utilisateur appuie et relâche son bouton droit de la souris sur un GUI afin que l'événement se lancer, considérez l'utilisation de GuiButton.MouseButton2Click.
Notez que cet événement ne se déclenchera que pour les boutons de GUI, y compris TextButtons et ImageButton. Il ne se déclenchera pas pour d'autres GuiObjects .
Paramètres
La coordonnée x de l'écran de la souris en pixels.
La coordonnée de l'écran de la souris en pixels.
Échantillons de code
local gui = script.Parent
local button = gui.Button
function rightMouseButtonUp(x, y)
print("Right mouse up", x, y)
end
function rightMouseButtonDown(x, y)
print("Right mouse down", x, y)
end
button.MouseButton2Up:Connect(rightMouseButtonUp)
button.MouseButton2Down:Connect(rightMouseButtonDown)