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.

CheckBox

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

Un bouton qui représente un choix binaire.

Description

CheckBox permet à l'utilisateur de choisir l'une des deux options possibles. C'est similaire à CheckButton dans la fonctionnalité, mais elle a une apparence différente. Pour suivre les modèles UX établis, il est recommandé d'utiliser CheckBox lorsqu'elle n'a pas d'effet immédiat sur quelque chose. Par exemple, elle pourrait être utilisée quand la cocher ne fera quelque chose qu'une fois un bouton de confirmation pressé.

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

Lorsque BaseButton.button_group spécifie un ButtonGroup, CheckBox modifie son apparence à celle d'un bouton radio et utilise les différentes propriétés radio_* du thème.

Propriétés

HorizontalAlignment

alignment

0 (overrides Button)

bool

toggle_mode

true (overrides BaseButton)

Propriétés du thème

Color

checkbox_checked_color

Color(1, 1, 1, 1)

Color

checkbox_unchecked_color

Color(1, 1, 1, 1)

int

check_v_offset

0

Texture2D

checked

Texture2D

checked_disabled

Texture2D

radio_checked

Texture2D

radio_checked_disabled

Texture2D

radio_unchecked

Texture2D

radio_unchecked_disabled

Texture2D

unchecked

Texture2D

unchecked_disabled


Descriptions des propriétés du thème

Color checkbox_checked_color = Color(1, 1, 1, 1) 🔗

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


Color checkbox_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é pour le rendu des icônes des coches (en pixels).


Texture2D checked 🔗

L'icône de coche à afficher quand la CheckBox est cochée.


Texture2D checked_disabled 🔗

L'icône de coche à afficher quand la CheckBox est cochée et désactivé.


Texture2D radio_checked 🔗

L'icône de coche à afficher quand la CheckBox est configurée comme un bouton radio et est cochée.


Texture2D radio_checked_disabled 🔗

L'icône de coche à afficher quand la CheckBox est configurée comme un bouton radio, désactivée, et décochée.


Texture2D radio_unchecked 🔗

L'icône de la coche à afficher quand la CheckBox est configurée comme un bouton radio et est décochée.


Texture2D radio_unchecked_disabled 🔗

L'icône de coche à afficher quand la CheckBox est configurée comme un bouton radio, désactivée, et décochée.


Texture2D unchecked 🔗

L'icône de la coche à afficher quand la CheckBox est décochée.


Texture2D unchecked_disabled 🔗

L'icône de coche à afficher quand la CheckBox est décochée et désactivée.