Button
Hérite de : BaseButton < Control < CanvasItem < Node < Object
Hérité par : CheckBox, CheckButton, ColorPickerButton, MenuButton, OptionButton
Un bouton à thème qui peut contenir du texte et une icône.
Description
Button est le bouton à thème standard. Il peut contenir du texte et une icône, et les affichera suivant le Theme actuellement défini.
Exemple : Créer un bouton et lui connecter une méthode qui sera appelée quand le bouton est appuyé :
func _ready():
var bouton = Button.new()
bouton.text = "Cliquez moi"
bouton.pressed.connect(_bouton_appuye)
add_child(bouton)
func _bouton_appuye():
print("On m'a cliqué !")
public override void _Ready()
{
var bouton = new Button();
bouton.Text = "Cliquez moi"
bouton.Pressed += BoutonAppuye;
AddChild(bouton);
}
private void BoutonAppuye()
{
GD.Print("On m'a cliqué !");
}
Voir aussi BaseButton qui contient les propriétés et méthodes communes associées à ce nœud.
Note : Les boutons n'interceptent pas les entrées tactiles et ne supporte donc pas le multi appui tactile, puisque l'émulation de la souris ne peut presser qu'un seul bouton à la fois. Utilisez TouchScreenButton pour les boutons qui déclenchent des actions ou des mouvements du gameplay.
Tutoriels
Propriétés
|
||
|
||
BitField[LineBreakFlag] |
|
|
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
Propriétés du thème
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
Descriptions des propriétés
HorizontalAlignment alignment = 1 🔗
void set_text_alignment(value: HorizontalAlignment)
HorizontalAlignment get_text_alignment()
Politique d'alignement du texte pour le texte du bouton.
AutowrapMode autowrap_mode = 0 🔗
void set_autowrap_mode(value: AutowrapMode)
AutowrapMode get_autowrap_mode()
Si défini à autre chose que TextServer.AUTOWRAP_OFF, le texte fait automatiquement des retours à la ligne dans le rectangle délimitant du nœud.
BitField[LineBreakFlag] autowrap_trim_flags = 128 🔗
void set_autowrap_trim_flags(value: BitField[LineBreakFlag])
BitField[LineBreakFlag] get_autowrap_trim_flags()
Drapeaux de trimming des espaces en autowrap. Voir TextServer.BREAK_TRIM_START_EDGE_SPACES et TextServer.BREAK_TRIM_END_EDGE_SPACES pour plus d'informations.
Si true, le texte trop grand pour correspondre au bouton est coupé horizontalement. Si false, le bouton sera toujours assez large pour contenir le texte. Le texte n'est pas coupé verticalement, et la hauteur du bouton n'est pas affectée par cette propriété.
Lors qu’activé, l'icône du bouton s'étendra/rétrécira pour correspondre à la taille du bouton tout en gardant son aspect. Voir aussi icon_max_width.
Les boutons plats n’affichent pas de décoration.
L'icône du bouton, si du texte est présent, l'icône sera placée avant le texte.
Pour modifier la marge et l'espacement de l'icône, utilisez la propriété de thème h_separation pour le Button et les propriétés content_margin_* des StyleBoxs utilisées.
HorizontalAlignment icon_alignment = 0 🔗
void set_icon_alignment(value: HorizontalAlignment)
HorizontalAlignment get_icon_alignment()
Spécifie si l'icône doit être alignée horizontalement sur la gauche, la droite ou au centre d'un bouton. Utilisez les mêmes constantes HorizontalAlignment que pour l'alignement du texte. Si centré horizontalement et verticalement, le texte sera dessiné sur l'icône.
Code de langue utilisé pour les algorithmes de retour à la ligne et de "text shaping". Si vide, la langue locale actuelle est utilisée à la place.
Le texte du bouton qui sera affiché à l'intérieur de l'aire du bouton.
TextDirection text_direction = 0 🔗
void set_text_direction(value: TextDirection)
TextDirection get_text_direction()
Direction d'écriture du texte de base.
OverrunBehavior text_overrun_behavior = 0 🔗
void set_text_overrun_behavior(value: OverrunBehavior)
OverrunBehavior get_text_overrun_behavior()
Définit le comportement de coupure lorsque le texte dépasse le rectangle délimitant du nœud.
VerticalAlignment vertical_icon_alignment = 1 🔗
void set_vertical_icon_alignment(value: VerticalAlignment)
VerticalAlignment get_vertical_icon_alignment()
Spécifie si l'icône doit être alignée verticalement sur le haut, le bas ou le centre d'un bouton. Utilise les mêmes constantes VerticalAlignment que pour l'alignement du texte. Si l'icône est centrée horizontalement et verticalement, elle sera affichée sur le texte.
Descriptions des propriétés du thème
Color font_color = Color(0.875, 0.875, 0.875, 1) 🔗
La Color du texte par défaut du Button.
Color font_disabled_color = Color(0.875, 0.875, 0.875, 0.5) 🔗
La Color du texte utilisée quand le Button est désactivé.
Color font_focus_color = Color(0.95, 0.95, 0.95, 1) 🔗
La Color du texte utilisée lorsque le Button a le focus. Ne fait que remplacer la couleur normale du texte du bouton. Les couleurs définies pour les états désactivé, survolé et pressé sont prioritaires sur cette couleur.
Color font_hover_color = Color(0.95, 0.95, 0.95, 1) 🔗
La Color du texte utilisée quand le Button est survolé.
Color font_hover_pressed_color = Color(1, 1, 1, 1) 🔗
La Color du texte utilisée quand le Button est survolé et appuyé.
Color font_outline_color = Color(0, 0, 0, 1) 🔗
La Color du contour du texte du Button.
Color font_pressed_color = Color(1, 1, 1, 1) 🔗
La Color du texte utilisée quand le Button est appuyé.
Color icon_disabled_color = Color(1, 1, 1, 0.4) 🔗
Color de modulation de l'icône utilisée quand le Button est désactivé.
Color icon_focus_color = Color(1, 1, 1, 1) 🔗
Color de modulation de l'icône utilisée quand le Button a le focus. Ne fait que remplacer la couleur de modulation normale du bouton. Les couleurs définies pour les états désactivé, survolé et appuyé sont prioritaires sur cette couleur.
Color icon_hover_color = Color(1, 1, 1, 1) 🔗
Color de modulation de l'icône utilisée quand le Button est survolé.
Color icon_hover_pressed_color = Color(1, 1, 1, 1) 🔗
Color de modulation de l'icône utilisée quand le Button est survolé et appuyé.
Color icon_normal_color = Color(1, 1, 1, 1) 🔗
Color de modulation de l'icône du Button par défaut.
Color icon_pressed_color = Color(1, 1, 1, 1) 🔗
Color de modulation de l'icône utilisée quand le Button est appuyé.
int align_to_largest_stylebox = 0 🔗
Cette constante agit comme un booléen. Si true, la taille minimale du bouton et l'alignement du texte/icône sont toujours basés sur les marges de la Stylebox la plus grande, sinon ils sont basés sur les marges de la Stylebox de l'état du bouton actuel.
L'espacement horizontal entre l'icône et le texte du Button. Les valeurs négatives seront traitées comme 0 lorsque utilisées.
La largeur maximale autorisée de l'icône du Button. Cette limite est appliquée en plus de la taille par défaut de l'icône, ou sa taille élargie si expand_icon vaut true. La hauteur est ajustée selon le rapport d'aspect de l'icône. Si le bouton a des icônes supplémentaires (par exemple CheckBox), elles seront également limitées.
Espacement vertical supplémentaire entre les lignes (en pixels), l'espacement est ajouté à la descente de la ligne. Cette valeur peut être négative.
La taille du contour du texte.
Note : Si vous utilisez une police avec FontFile.multichannel_signed_distance_field activé, sa propriété FontFile.msdf_pixel_range doit être définie à au moins deux fois la valeur de outline_size pour que le rendu des contours soit correct. Sinon, le contour peut sembler coupé plus tôt que prévu.
Font du texte du Button.
La taille de police du texte du Button.
Icône par défaut pour le Button. N'apparaît que si icon n'est pas affectée.
La StyleBox utilisée quand le Button est désactivé.
StyleBox utilisée lorsque le Button est désactivé (pour les dispositions de droite à gauche).
StyleBox utilisée lorsque le Button a le focus. La StyleBox du focus est affichée sur la StyleBox de base, donc une StyleBox partiellement transparente devrait être utilisée pour s'assurer que la StyleBox de base reste visible. Une StyleBox qui représente un contour ou un sous-lignage fonctionne bien à cette fin. Pour désactiver l'effet visuel du focus, assignez une ressource StyleBoxEmpty. Notez que la désactivation de l'effet visuel du focus va nuire à l'utilisabilité de la navigation avec clavier/contrôleur, ce qui n'est donc pas recommandé pour des raisons d'accessibilité.
Le StyleBox utilisé quand le Button est survolé.
StyleBox utilisée lorsque le Button est survolé (pour les dispositions de droite à gauche).
StyleBox utilisée quand le Button est appuyé et survolé en même temps.
StyleBox hover_pressed_mirrored 🔗
StyleBox utilisée quand le Button est appuyé et survolé en même temps (pour les mises en pages droite à gauche).
StyleBox par défaut pour le Button.
La StyleBox par défaut pour le Button (pour les mises en page de droite à gauche).
Le StyleBox utilisé quand le Button est appuyé.
StyleBox utilisée quand le Button est appuyé en même temps (pour les mises en page droite à gauche).