Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

CheckButton

Hérite de : Button < BaseButton < Control < CanvasItem < Node < Object

Un bouton qui représente un choix binaire.

Description

CheckButton est un bouton à bascule affiché avec une case à cocher. Il est semblable à CheckBox dans ses fonctionnalités, mais son apparence est différente. Pour suivre les modèles UX établis, il est recommandé d'utiliser CheckButton quand l'activer a un effet immédiat sur quelque chose. Par exemple, il devrait être utilisé si le basculement affiche ou cache des paramètres avancés, sans demander à ce que l'utilisateur confirme cette action.

Voir aussi BaseButton qui contient des propriétés et des méthodes communes associées à ce nœud.

Propriétés

HorizontalAlignment

alignment

0 (overrides Button)

bool

toggle_mode

true (overrides BaseButton)

Propriétés du thème

Color

button_checked_color

Color(1, 1, 1, 1)

Color

button_unchecked_color

Color(1, 1, 1, 1)

int

check_v_offset

0

Texture2D

checked

Texture2D

checked_disabled

Texture2D

checked_disabled_mirrored

Texture2D

checked_mirrored

Texture2D

unchecked

Texture2D

unchecked_disabled

Texture2D

unchecked_disabled_mirrored

Texture2D

unchecked_mirrored


Descriptions des propriétés du thème

Color button_checked_color = Color(1, 1, 1, 1) 🔗

La couleur de l'icône de coche lorsque la case à cocher est cochée.


Color button_unchecked_color = Color(1, 1, 1, 1) 🔗

La couleur de l'icône de coche lorsque la case à cocher n'est pas cochée.


int check_v_offset = 0 🔗

Le décalage vertical utilisé lors du rendu des icônes de basculement (en pixels).


Texture2D checked 🔗

L'icône à afficher quand le CheckButton est coché (pour les mises en page gauche vers droite).


Texture2D checked_disabled 🔗

L'icône à afficher quand le CheckButton est coché et désactivé (pour les mises en page gauche vers droite).


Texture2D checked_disabled_mirrored 🔗

L'icône à afficher quand le CheckButton est coché et désactivé (pour les mises en page droite vers gauche).


Texture2D checked_mirrored 🔗

L'icône à afficher quand le CheckButton est coché (pour les mises en page droite vers gauche).


Texture2D unchecked 🔗

L'icône à afficher quand le CheckButton est décoché (pour les mises en page gauche vers droite).


Texture2D unchecked_disabled 🔗

L'icône à afficher quand le CheckButton est décoché et désactivé (pour les mises en page gauche vers droite).


Texture2D unchecked_disabled_mirrored 🔗

L'icône à afficher quand le CheckButton est décoché et désactivé (pour les mises en page droite vers gauche).


Texture2D unchecked_mirrored 🔗

L'icône à afficher quand le CheckButton est décoché (pour les mises en page droite vers gauche).