Contrôle CONTROL

Définit un contrôle défini par l’utilisateur.

CONTROL text, id, class, style, x, y, width, height [, extended-style]

Classe

Nom redéfini, chaîne de caractères ou valeur entière non signée 16 bits qui définit la classe. Il peut s’agir de n’importe quelle classe de contrôle ; pour obtenir la liste des classes de contrôle, consultez la première liste qui suit cette description. Si la valeur est un nom redéfini fourni par l’application, il doit s’agir d’une chaîne placée entre guillemets doubles (« ).

Style

Nom redéfini ou valeur entière qui spécifie le style du contrôle donné. La signification exacte du style dépend de la valeur de la classe . Les sections qui suivent cette description montrent les classes de contrôle et les styles correspondants.

Pour plus d’informations sur la syntaxe générale d’une instruction de contrôle, consultez Paramètres de contrôle communs.

Notes

Les six classes de contrôle possibles sont décrites dans les sections suivantes.

Classe de contrôle Button

Un contrôle de bouton est une petite fenêtre enfant rectangulaire que l’utilisateur peut activer ou désactiver en cliquant dessus avec la souris. Les contrôles de bouton peuvent être utilisés seuls ou en groupes, et peuvent être étiquetés ou apparaître sans texte. Les contrôles de bouton changent généralement d’apparence lorsque l’utilisateur clique dessus.

Les styles de bouton sont décrits dans la rubrique suivante : Styles de bouton.

Classe de contrôle zone de liste déroulante

Les contrôles de zone de liste modifiable se composent d’un champ de sélection similaire à un contrôle d’édition plus d’une zone de liste. La zone de liste peut être affichée à tout moment ou être supprimée lorsque l’utilisateur sélectionne une « boîte contextuelle » en regard du champ de sélection.

Selon le style de la zone de liste déroulante, l’utilisateur peut ou ne peut pas modifier le contenu du champ de sélection. Si la zone de liste est visible, la saisie de caractères dans la zone de sélection entraîne la mise en surbrillance de la première entrée qui correspond aux caractères tapés. À l’inverse, la sélection d’un élément dans la zone de liste affiche le texte sélectionné dans le champ de sélection.

Les styles de contrôle de zone de liste modifiable sont décrits dans la rubrique suivante : Styles de zone de liste déroulante.

Classe de contrôle Edit

Un contrôle d’édition est une fenêtre enfant rectangulaire dans laquelle l’utilisateur peut entrer du texte à partir du clavier. L’utilisateur sélectionne le contrôle et lui donne le focus d’entrée en cliquant sur la souris à l’intérieur ou en appuyant sur la touche TAB. L’utilisateur peut entrer du texte lorsque le contrôle affiche un point d’insertion clignotant. La souris peut être utilisée pour déplacer le curseur et sélectionner des caractères à remplacer, ou pour positionner le curseur pour l’insertion de caractères. La clé BACKSPACE peut être utilisée pour supprimer des caractères.

Les contrôles Modifier utilisent la police à pas fixe et affichent des caractères Unicode. Ils développent les caractères de tabulation en autant de caractères d’espace que nécessaire pour déplacer le curseur vers le taquet de tabulation suivant. Les taquets de tabulation sont supposés se trouver à chaque position de huitième caractère.

Les styles de contrôle de modification sont décrits dans la rubrique suivante : Modifier les styles de contrôle.

Classe de contrôle List Box

Les contrôles de zone de liste se composent d’une liste de chaînes de caractères. Le contrôle est utilisé chaque fois qu’une application a besoin de présenter une liste de noms, tels que des noms de fichiers, que l’utilisateur peut afficher et sélectionner. L’utilisateur peut sélectionner une chaîne en pointant sur la chaîne avec la souris et en cliquant sur un bouton de la souris. Lorsqu’une chaîne est sélectionnée, elle est mise en surbrillance et un message de notification est passé à la fenêtre parente. Une barre de défilement peut être utilisée avec un contrôle de zone de liste pour faire défiler des listes trop longues ou trop larges pour la fenêtre de contrôle.

Les styles de contrôle de zone de liste sont décrits dans la rubrique suivante : Styles de zone de liste.

Classe de contrôle Scroll-Bar

Un contrôle de barre de défilement est un rectangle qui contient un pouce de défilement et des flèches de direction aux deux extrémités. La barre de défilement envoie un message de notification à son parent chaque fois que l’utilisateur clique sur la souris dans le contrôle. Le parent est responsable de la mise à jour de la position du pouce, si nécessaire. Les contrôles de barre de défilement ont la même apparence et fonctionnent que les barres de défilement utilisées dans les fenêtres ordinaires. Mais contrairement aux barres de défilement, les contrôles de barre de défilement peuvent être positionnés n’importe où dans une fenêtre et utilisés chaque fois que nécessaire pour fournir une entrée de défilement pour une fenêtre.

Les styles de barre de défilement sont décrits dans la rubrique suivante : Styles de contrôle de barre de défilement.

Classe de contrôle statique

Les contrôles statiques sont des champs de texte, des zones et des rectangles simples qui peuvent être utilisés pour étiqueter, boxer ou séparer d’autres contrôles. Les contrôles statiques ne prennent aucune entrée et ne fournissent aucune sortie.

Les styles de contrôle statiques sont décrits dans la rubrique suivante : Styles de contrôle statiques.