:github_url: hide .. _class_Button: Button ====== **Hérite de :** :ref:`BaseButton` **<** :ref:`Control` **<** :ref:`CanvasItem` **<** :ref:`Node` **<** :ref:`Object` **Hérité par :** :ref:`CheckBox`, :ref:`CheckButton`, :ref:`ColorPickerButton`, :ref:`MenuButton`, :ref:`OptionButton` Un bouton à thème qui peut contenir du texte et une icône. .. rst-class:: classref-introduction-group Description ----------- **Button** est le bouton à thème standard. Il peut contenir du texte et une icône, et les affichera suivant le :ref:`Theme` actuellement défini. \ **Exemple :** Créer un bouton et lui connecter une méthode qui sera appelée quand le bouton est appuyé : .. tabs:: .. code-tab:: gdscript 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é !") .. code-tab:: csharp 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 :ref:`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 :ref:`TouchScreenButton` pour les boutons qui déclenchent des actions ou des mouvements du gameplay. .. rst-class:: classref-introduction-group Tutoriels ------------------ - `Démo 2D « Dodge The Creeps » `__ - `Démo de test de système d'exploitation `__ .. rst-class:: classref-reftable-group Propriétés -------------------- .. table:: :widths: auto +-------------------------------------------------------------------+-------------------------------------------------------------------------------+-----------+ | :ref:`HorizontalAlignment` | :ref:`alignment` | ``1`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------+-----------+ | :ref:`AutowrapMode` | :ref:`autowrap_mode` | ``0`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------+-----------+ | |bitfield|\[:ref:`LineBreakFlag`\] | :ref:`autowrap_trim_flags` | ``128`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------+-----------+ | :ref:`bool` | :ref:`clip_text` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------+-----------+ | :ref:`bool` | :ref:`expand_icon` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------+-----------+ | :ref:`bool` | :ref:`flat` | ``false`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------+-----------+ | :ref:`Texture2D` | :ref:`icon` | | +-------------------------------------------------------------------+-------------------------------------------------------------------------------+-----------+ | :ref:`HorizontalAlignment` | :ref:`icon_alignment` | ``0`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------+-----------+ | :ref:`String` | :ref:`language` | ``""`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------+-----------+ | :ref:`String` | :ref:`text` | ``""`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------+-----------+ | :ref:`TextDirection` | :ref:`text_direction` | ``0`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------+-----------+ | :ref:`OverrunBehavior` | :ref:`text_overrun_behavior` | ``0`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------+-----------+ | :ref:`VerticalAlignment` | :ref:`vertical_icon_alignment` | ``1`` | +-------------------------------------------------------------------+-------------------------------------------------------------------------------+-----------+ .. rst-class:: classref-reftable-group Propriétés du thème -------------------------------------- .. table:: :widths: auto +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_color` | ``Color(0.875, 0.875, 0.875, 1)`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_disabled_color` | ``Color(0.875, 0.875, 0.875, 0.5)`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_focus_color` | ``Color(0.95, 0.95, 0.95, 1)`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_hover_color` | ``Color(0.95, 0.95, 0.95, 1)`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_hover_pressed_color` | ``Color(1, 1, 1, 1)`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_outline_color` | ``Color(0, 0, 0, 1)`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_pressed_color` | ``Color(1, 1, 1, 1)`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`icon_disabled_color` | ``Color(1, 1, 1, 0.4)`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`icon_focus_color` | ``Color(1, 1, 1, 1)`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`icon_hover_color` | ``Color(1, 1, 1, 1)`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`icon_hover_pressed_color` | ``Color(1, 1, 1, 1)`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`icon_normal_color` | ``Color(1, 1, 1, 1)`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`icon_pressed_color` | ``Color(1, 1, 1, 1)`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`align_to_largest_stylebox` | ``0`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`h_separation` | ``4`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`icon_max_width` | ``0`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`line_spacing` | ``0`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`outline_size` | ``0`` | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Font` | :ref:`font` | | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`font_size` | | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Texture2D` | :ref:`icon` | | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`disabled` | | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`disabled_mirrored` | | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`focus` | | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`hover` | | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`hover_mirrored` | | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`hover_pressed` | | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`hover_pressed_mirrored` | | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`normal` | | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`normal_mirrored` | | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`pressed` | | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`pressed_mirrored` | | +-----------------------------------+-----------------------------------------------------------------------------------------+-------------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descriptions des propriétés ------------------------------------------------------ .. _class_Button_property_alignment: .. rst-class:: classref-property :ref:`HorizontalAlignment` **alignment** = ``1`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_text_alignment**\ (\ value\: :ref:`HorizontalAlignment`\ ) - :ref:`HorizontalAlignment` **get_text_alignment**\ (\ ) Politique d'alignement du texte pour le texte du bouton. .. rst-class:: classref-item-separator ---- .. _class_Button_property_autowrap_mode: .. rst-class:: classref-property :ref:`AutowrapMode` **autowrap_mode** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_autowrap_mode**\ (\ value\: :ref:`AutowrapMode`\ ) - :ref:`AutowrapMode` **get_autowrap_mode**\ (\ ) Si défini à autre chose que :ref:`TextServer.AUTOWRAP_OFF`, le texte fait automatiquement des retours à la ligne dans le rectangle délimitant du nœud. .. rst-class:: classref-item-separator ---- .. _class_Button_property_autowrap_trim_flags: .. rst-class:: classref-property |bitfield|\[:ref:`LineBreakFlag`\] **autowrap_trim_flags** = ``128`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_autowrap_trim_flags**\ (\ value\: |bitfield|\[:ref:`LineBreakFlag`\]\ ) - |bitfield|\[:ref:`LineBreakFlag`\] **get_autowrap_trim_flags**\ (\ ) Drapeaux de trimming des espaces en autowrap. Voir :ref:`TextServer.BREAK_TRIM_START_EDGE_SPACES` et :ref:`TextServer.BREAK_TRIM_END_EDGE_SPACES` pour plus d'informations. .. rst-class:: classref-item-separator ---- .. _class_Button_property_clip_text: .. rst-class:: classref-property :ref:`bool` **clip_text** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_clip_text**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **get_clip_text**\ (\ ) 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é. .. rst-class:: classref-item-separator ---- .. _class_Button_property_expand_icon: .. rst-class:: classref-property :ref:`bool` **expand_icon** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_expand_icon**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_expand_icon**\ (\ ) 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 :ref:`icon_max_width`. .. rst-class:: classref-item-separator ---- .. _class_Button_property_flat: .. rst-class:: classref-property :ref:`bool` **flat** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_flat**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_flat**\ (\ ) Les boutons plats n’affichent pas de décoration. .. rst-class:: classref-item-separator ---- .. _class_Button_property_icon: .. rst-class:: classref-property :ref:`Texture2D` **icon** :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_button_icon**\ (\ value\: :ref:`Texture2D`\ ) - :ref:`Texture2D` **get_button_icon**\ (\ ) 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 :ref:`h_separation` pour le **Button** et les propriétés ``content_margin_*`` des :ref:`StyleBox`\ s utilisées. .. rst-class:: classref-item-separator ---- .. _class_Button_property_icon_alignment: .. rst-class:: classref-property :ref:`HorizontalAlignment` **icon_alignment** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_icon_alignment**\ (\ value\: :ref:`HorizontalAlignment`\ ) - :ref:`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 :ref:`HorizontalAlignment` que pour l'alignement du texte. Si centré horizontalement et verticalement, le texte sera dessiné sur l'icône. .. rst-class:: classref-item-separator ---- .. _class_Button_property_language: .. rst-class:: classref-property :ref:`String` **language** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_language**\ (\ ) Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead. .. rst-class:: classref-item-separator ---- .. _class_Button_property_text: .. rst-class:: classref-property :ref:`String` **text** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_text**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_text**\ (\ ) Le texte du bouton qui sera affiché à l'intérieur de l'aire du bouton. .. rst-class:: classref-item-separator ---- .. _class_Button_property_text_direction: .. rst-class:: classref-property :ref:`TextDirection` **text_direction** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_text_direction**\ (\ value\: :ref:`TextDirection`\ ) - :ref:`TextDirection` **get_text_direction**\ (\ ) Direction d'écriture du texte de base. .. rst-class:: classref-item-separator ---- .. _class_Button_property_text_overrun_behavior: .. rst-class:: classref-property :ref:`OverrunBehavior` **text_overrun_behavior** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_text_overrun_behavior**\ (\ value\: :ref:`OverrunBehavior`\ ) - :ref:`OverrunBehavior` **get_text_overrun_behavior**\ (\ ) Définit le comportement de coupure lorsque le texte dépasse le rectangle délimitant du nœud. .. rst-class:: classref-item-separator ---- .. _class_Button_property_vertical_icon_alignment: .. rst-class:: classref-property :ref:`VerticalAlignment` **vertical_icon_alignment** = ``1`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_vertical_icon_alignment**\ (\ value\: :ref:`VerticalAlignment`\ ) - :ref:`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 :ref:`VerticalAlignment` que pour l'alignement du texte. Si l'icône est centrée horizontalement et verticalement, elle sera affichée sur le texte. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descriptions des propriétés du thème ------------------------------------------------------------------------ .. _class_Button_theme_color_font_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗` La :ref:`Color` du texte par défaut du **Button**. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_color_font_disabled_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_disabled_color** = ``Color(0.875, 0.875, 0.875, 0.5)`` :ref:`🔗` La :ref:`Color` du texte utilisée quand le **Button** est désactivé. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_color_font_focus_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_focus_color** = ``Color(0.95, 0.95, 0.95, 1)`` :ref:`🔗` La :ref:`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. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_color_font_hover_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_hover_color** = ``Color(0.95, 0.95, 0.95, 1)`` :ref:`🔗` La :ref:`Color` du texte utilisée quand le **Button** est survolé. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_color_font_hover_pressed_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_hover_pressed_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` La :ref:`Color` du texte utilisée quand le **Button** est survolé et appuyé. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_color_font_outline_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_outline_color** = ``Color(0, 0, 0, 1)`` :ref:`🔗` La :ref:`Color` du contour du texte du **Button**. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_color_font_pressed_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_pressed_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` La :ref:`Color` du texte utilisée quand le **Button** est appuyé. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_color_icon_disabled_color: .. rst-class:: classref-themeproperty :ref:`Color` **icon_disabled_color** = ``Color(1, 1, 1, 0.4)`` :ref:`🔗` :ref:`Color` de modulation de l'icône utilisée quand le **Button** est désactivé. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_color_icon_focus_color: .. rst-class:: classref-themeproperty :ref:`Color` **icon_focus_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` :ref:`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. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_color_icon_hover_color: .. rst-class:: classref-themeproperty :ref:`Color` **icon_hover_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` :ref:`Color` de modulation de l'icône utilisée quand le **Button** est survolé. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_color_icon_hover_pressed_color: .. rst-class:: classref-themeproperty :ref:`Color` **icon_hover_pressed_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` :ref:`Color` de modulation de l'icône utilisée quand le **Button** est survolé et appuyé. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_color_icon_normal_color: .. rst-class:: classref-themeproperty :ref:`Color` **icon_normal_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` :ref:`Color` de modulation de l'icône du **Button** par défaut. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_color_icon_pressed_color: .. rst-class:: classref-themeproperty :ref:`Color` **icon_pressed_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` :ref:`Color` de modulation de l'icône utilisée quand le **Button** est appuyé. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_constant_align_to_largest_stylebox: .. rst-class:: classref-themeproperty :ref:`int` **align_to_largest_stylebox** = ``0`` :ref:`🔗` 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. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_constant_h_separation: .. rst-class:: classref-themeproperty :ref:`int` **h_separation** = ``4`` :ref:`🔗` L'espacement horizontal entre l'icône et le texte du **Button**. Les valeurs négatives seront traitées comme ``0`` lorsque utilisées. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_constant_icon_max_width: .. rst-class:: classref-themeproperty :ref:`int` **icon_max_width** = ``0`` :ref:`🔗` 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 :ref:`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 :ref:`CheckBox`), elles seront également limitées. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_constant_line_spacing: .. rst-class:: classref-themeproperty :ref:`int` **line_spacing** = ``0`` :ref:`🔗` Espacement vertical supplémentaire entre les lignes (en pixels), l'espacement est ajouté à la descente de la ligne. Cette valeur peut être négative. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_constant_outline_size: .. rst-class:: classref-themeproperty :ref:`int` **outline_size** = ``0`` :ref:`🔗` La taille du contour du texte. \ **Note :** Si vous utilisez une police avec :ref:`FontFile.multichannel_signed_distance_field` activé, sa propriété :ref:`FontFile.msdf_pixel_range` doit être définie à au moins *deux fois* la valeur de :ref:`outline_size` pour que le rendu des contours soit correct. Sinon, le contour peut sembler coupé plus tôt que prévu. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_font_font: .. rst-class:: classref-themeproperty :ref:`Font` **font** :ref:`🔗` :ref:`Font` du texte du **Button**. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_font_size_font_size: .. rst-class:: classref-themeproperty :ref:`int` **font_size** :ref:`🔗` La taille de police du texte du **Button**. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_icon_icon: .. rst-class:: classref-themeproperty :ref:`Texture2D` **icon** :ref:`🔗` Icône par défaut pour le **Button**. N'apparaît que si :ref:`icon` n'est pas affectée. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_style_disabled: .. rst-class:: classref-themeproperty :ref:`StyleBox` **disabled** :ref:`🔗` La :ref:`StyleBox` utilisée quand le **Button** est désactivé. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_style_disabled_mirrored: .. rst-class:: classref-themeproperty :ref:`StyleBox` **disabled_mirrored** :ref:`🔗` :ref:`StyleBox` utilisée lorsque le **Button** est désactivé (pour les dispositions de droite à gauche). .. rst-class:: classref-item-separator ---- .. _class_Button_theme_style_focus: .. rst-class:: classref-themeproperty :ref:`StyleBox` **focus** :ref:`🔗` :ref:`StyleBox` utilisée lorsque le **Button** a le focus. La :ref:`StyleBox` du :ref:`focus` est affichée *sur* la :ref:`StyleBox` de base, donc une :ref:`StyleBox` partiellement transparente devrait être utilisée pour s'assurer que la :ref:`StyleBox` de base reste visible. Une :ref:`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 :ref:`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é. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_style_hover: .. rst-class:: classref-themeproperty :ref:`StyleBox` **hover** :ref:`🔗` Le :ref:`StyleBox` utilisé quand le **Button** est survolé. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_style_hover_mirrored: .. rst-class:: classref-themeproperty :ref:`StyleBox` **hover_mirrored** :ref:`🔗` :ref:`StyleBox` utilisée lorsque le **Button** est survolé (pour les dispositions de droite à gauche). .. rst-class:: classref-item-separator ---- .. _class_Button_theme_style_hover_pressed: .. rst-class:: classref-themeproperty :ref:`StyleBox` **hover_pressed** :ref:`🔗` :ref:`StyleBox` utilisée quand le **Button** est appuyé et survolé en même temps. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_style_hover_pressed_mirrored: .. rst-class:: classref-themeproperty :ref:`StyleBox` **hover_pressed_mirrored** :ref:`🔗` :ref:`StyleBox` utilisée quand le **Button** est appuyé et survolé en même temps (pour les mises en pages droite à gauche). .. rst-class:: classref-item-separator ---- .. _class_Button_theme_style_normal: .. rst-class:: classref-themeproperty :ref:`StyleBox` **normal** :ref:`🔗` :ref:`StyleBox` par défaut pour le **Button**. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_style_normal_mirrored: .. rst-class:: classref-themeproperty :ref:`StyleBox` **normal_mirrored** :ref:`🔗` La :ref:`StyleBox` par défaut pour le **Button** (pour les mises en page de droite à gauche). .. rst-class:: classref-item-separator ---- .. _class_Button_theme_style_pressed: .. rst-class:: classref-themeproperty :ref:`StyleBox` **pressed** :ref:`🔗` Le :ref:`StyleBox` utilisé quand le **Button** est appuyé. .. rst-class:: classref-item-separator ---- .. _class_Button_theme_style_pressed_mirrored: .. rst-class:: classref-themeproperty :ref:`StyleBox` **pressed_mirrored** :ref:`🔗` :ref:`StyleBox` utilisée quand le **Button** est appuyé en même temps (pour les mises en page droite à gauche). .. |virtual| replace:: :abbr:`virtual (Cette méthode doit typiquement être redéfinie par l'utilisateur pour avoir un effet.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Cette méthode n'a pas d'effets de bord. Elle ne modifie aucune des variables membres de l'instance.)` .. |vararg| replace:: :abbr:`vararg (Cette méthode accepte n'importe quel nombre d'arguments après ceux décris ici.)` .. |constructor| replace:: :abbr:`constructor (Cette méthode est utilisée pour construire un type.)` .. |static| replace:: :abbr:`static (Cette méthode n'a pas besoin d'instance pour être appelée, elle peut donc être directement appelée en utilisant le nom de la classe.)` .. |operator| replace:: :abbr:`operator (Cette méthode décrit un opérateur valide à utiliser avec ce type en tant qu'opérande gauche.)` .. |bitfield| replace:: :abbr:`BitField (Cette valeur est un nombre entier composé d'un masque de bits des options suivantes.)` .. |void| replace:: :abbr:`void (Aucune valeur de retour.)`