Objet CheckBox (Outlook Forms Script)

Affiche l'état de sélection d'un élément.

Remarques

Utilisez un objet CheckBox pour offrir à l’utilisateur le choix entre deux valeurs, telles que Oui/Non, Vrai/Faux ou Actif/Inactif. Lorsque l’utilisateur sélectionne un objet CheckBox, celui-ci affiche une marque spéciale (par exemple, un X) et sa valeur est Oui, Vrai ou Actif. Si l’utilisateur ne sélectionne pas l’objet CheckBox, celui-ci est vide et sa valeur est Non, Faux ou Inactif. Selon la valeur de la propriété TripleState , un contrôle CheckBox peut également avoir une valeur Null .

Si un contrôle CheckBox est lié à une source de données, le fait de modifier sa valeur a une répercussion sur celle de la source. Un objet CheckBox désactivé affiche sa valeur, mais il est estompé et n'autorise pas les modifications de sa valeur à partir de l'interface utilisateur.

Vous avez également la possibilité d'utiliser des cases à cocher à l'intérieur d'une zone de groupe, dans laquelle l'utilisateur sélectionne un ou plusieurs éléments apparentés. Par exemple, créez un formulaire de commande qui contient une liste d'éléments disponibles, avec un contrôle CheckBox précédant chaque élément. L'utilisateur sélectionne un ou plusieurs éléments spécifiques en cochant le contrôle CheckBox correspondant.

La propriété par défaut d’un contrôle CheckBox est la propriété Value .

ListBox vous permet également de mettre une coche en fonction des options sélectionnées. Selon votre application, vous pouvez utiliser l'objet ListBox au lieu d'un groupe de contrôles CheckBox.

Événements

Nom	Description
Click	Se produit lorsque l’utilisateur clique dans le contrôle.

Propriétés

Nom	Description
Accelerator	Renvoie ou définit la touche d'accès rapide d'un contrôle. En lecture/écriture
Alignment	Renvoie ou définit une valeur de type Integer qui indique la position d’un contrôle par rapport à sa légende. Lecture-écriture.
AutoSize	Renvoie ou définit une valeur booléenne qui spécifie si un objet se redimensionne automatiquement pour afficher son contenu entier. Lecture-écriture.
BackColor	Renvoie ou définit une valeur de type Long qui spécifie la couleur d’arrière-plan de l’objet. Lecture-écriture.
BackStyle	Renvoie ou définit une valeur de type Integer qui spécifie le style d’arrière-plan d’un objet. En lecture/écriture
Caption	Renvoie ou définit une valeur de type String qui apparaît sur un objet pour l'identifier ou le décrire. En lecture/écriture
Enabled	Renvoie ou définit une valeur booléenne qui spécifie si un contrôle peut recevoir le focus et répondre aux événements générés par l’utilisateur. Lecture-écriture.
ForeColor	Renvoie ou définit une valeur de type Long qui spécifie la couleur d'avant-plan d'un objet. En lecture/écriture
GroupName	Renvoie ou définit une valeur de type String qui identifie un groupe de contrôles CheckBox qui s’excluent mutuellement. En lecture/écriture
Locked	Renvoie ou définit une valeur de type Boolean qui spécifie si un contrôle peut être modifié. Lecture-écriture.
MouseIcon	Renvoie une valeur de type String qui représente le nom complet du chemin d’accès d’une icône personnalisée qui doit être affectée au contrôle. En lecture seule.
MousePointer	Renvoie ou définit une valeur de type Integer qui spécifie le type de pointeur affiché lorsque l’utilisateur positionne la souris sur un objet particulier. Lecture-écriture.
Picture	Retourne une valeur de type String qui spécifie le nom complet du chemin d’accès d’une image bitmap à afficher sur un contrôle. En lecture seule.
PicturePosition	Renvoie ou définit un entier qui spécifie l’emplacement de l’image par rapport à sa légende. En lecture/écriture
SpecialEffect	Renvoie ou définit une valeur de type Integer qui spécifie l’apparence visuelle d’un objet. Lecture-écriture.
TextAlign	Renvoie ou définit une valeur de type Integer qui spécifie le mode d'alignement du texte dans un contrôle. Lecture-écriture.
TripleState	Renvoie ou définit une valeur booléenne qui détermine si un utilisateur peut spécifier, à partir de l’interface utilisateur, l’état Null d’un Contrôle CheckBox. Lecture-écriture.
Valeur	Renvoie ou définit une valeur de type Variant qui spécifie si la case à cocher est activée. En lecture/écriture
WordWrap	Renvoie ou définit une valeur de type Boolean qui spécifie si le contenu d'un contrôle est automatiquement renvoyé à ligne en fin de ligne, ou si le contrôle s'étend pour s'ajuster à la taille du texte. En lecture/écriture

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.