CheckBox, contrôle

Ce CheckBox_control est une case à cocher à deux états. Pour associer une propriété de type entier ou chaîne à ce contrôle, entrez le nom de la propriété dans la colonne Property de la table Control. L’état sélectionné de la case définit la propriété sur la valeur spécifiée dans la colonne Value de la table CheckBox ou sur la valeur initiale de la propriété spécifiée dans la table Property. Si la propriété n’a pas de valeur initiale, l’état coché la définit sur 1. L’état non sélectionné définit la propriété sur null.

Les contrôles CheckBox peuvent uniquement être utilisés pour publier des contrôles ControlEvent AddLocal, ControlEvent AddSource, ControlEvent Remove, ControlEvent DoAction ou ControlEvent SetProperty.

Attributs de contrôle

Vous pouvez utiliser les attributs suivants avec ce contrôle. Pour modifier la valeur d’un attribut à l’aide d’un événement, abonnez le contrôle à un ControlEvent dans la table EventMapping, et répertoriez l’identificateur de l’attribut dans la colonne Attribut. Entrez l’identificateur de ControlEvent dans la colonne Event.

Identificateur d’attribut	Bit hexadécimal	Description
IndirectPropertyName		Nom d’une propriété indirecte associée au contrôle. Si le bit d’attribut Indirect est défini, le contrôle affiche ou modifie la valeur de la propriété portant ce nom, nom qui constitue également la valeur de la propriété figurant dans la colonne Property de la table Control.
Position		Position du contrôle dans la boîte de dialogue. Si le bit d’attribut indirect est défini, ce nom est également la valeur de la propriété répertoriée dans la colonne Propriété de la table Control. Utilisez les unités du programme d’installation pour la longueur et la distance.
PropertyName		Nom de la propriété associée à ce contrôle. Si le bit d’attribut Indirect n’est pas défini, le contrôle affiche ou modifie la valeur de la propriété portant ce nom. Cet attribut est spécifié dans la colonne Property de la table Control.
PropertyValue		Valeur actuelle de la propriété affichée ou modifiée par ce contrôle. Si le bit d’attribut Indirect n’est pas défini, il s’agit de la valeur de PropertyName. S’il est défini, il s’agit de la valeur d’IndirectPropertyName. Lorsque l’attribut change, le contrôle reflète la nouvelle valeur.
Texte		Cet attribut de contrôle peut spécifier le texte affiché par le contrôle, une image stockée dans la table Binaire ou une image définie au moment de l’exécution. Pour spécifier du texte, entrez la chaîne de texte dans la colonne Texte de la table Contrôle. Pour définir la police et le style de police d’une chaîne de texte, préfixez la chaîne des caractères affichés avec {\style} ou {&style}. Où style est un identificateur répertorié dans la colonne TextStyle de la table TextStyle. Si aucun de ces éléments n’est présent, mais que la propriété DefaultUIFont est définie comme un style de texte valide, cette police est utilisée. Pour spécifier une icône ou une image bitmap stockée dans la table Binary, entrez la clé primaire de l’enregistrement de l’image à partir de la colonne Name, de la table Binary, dans la colonne Text de l’enregistrement de l’enregistrement de la table Control pour le contrôle.
Visible	0x00000000 0x00000001	Contrôle masqué. Contrôle visible. Incluez ce bit dans le mot de bit de la colonne Attributes dans la table Control pour rendre le contrôle visible ou masqué lors de sa création. Vous pouvez également masquer ou afficher un contrôle à l’aide de la table ControlCondition.
Activé	0x00000000 0x00000002	Contrôle dans un état désactivé. Contrôle dans un état activé. Incluez ce bit dans la colonne Attributes de la table Control pour activer le contrôle lors de la création. Vous pouvez également activer ou désactiver un contrôle à l’aide de la table ControlCondition.
Sunken	0x00000000 0x00000004	Affiche le style visuel par défaut. Affiche le contrôle avec un aspect 3D enfoncé. Incluez ces bits dans le mot bit dans la colonne Attributes de la table Control.
Indirect	0x00000000 0x00000008	Le contrôle affiche ou modifie la valeur de la propriété dans la colonne Property de la table Control. Le contrôle affiche ou modifie la valeur de la propriété dont l’identificateur est répertorié dans la colonne Property de la table Control. Détermine si la propriété associée à ce contrôle est référencée indirectement.
Integer	0x00000000 0x00000010	La propriété associée au contrôle est une valeur de chaîne. La propriété associée au contrôle est une valeur d’entier. Incluez ce bit dans la colonne Attributes de la table Control pour définir cet attribut au moment de la création du contrôle.
RTLRO	0x00000000 0x00000020	Le texte du contrôle s’affiche dans l’ordre de lecture de gauche à droite. Le texte du contrôle s’affiche dans l’ordre de lecture de droite à gauche.
RightAligned	0x00000000 0x00000040	Le texte du contrôle est aligné à gauche. Le texte du contrôle est aligné à droite.
PushLike	0x00000000 0x00020000	Le contrôle est dessiné avec son apparence habituelle. Le contrôle a le style BS_PUSHLIKE et est dessiné pour apparaître sous la forme d’un bouton. Incluez ce bit dans le mot de bit de la colonne Attributes de la table Control pour définir cet attribut lors de la création du contrôle.

Notes

Ce contrôle peut être créé à partir de la classe BUTTON à l’aide de la fonction CreateWindowEx. Il a les styles BS_CHECKBOX, WS_TABSTOP, WS_GROUP, WS_CHILD et BS_MULTILINE.