Paramètres de contrôle courants

Ce qui suit décrit la syntaxe générale d’une instruction de définition de ressource de contrôle. La signification de chaque paramètre est donnée ci-dessous. Parfois, une instruction utilise un paramètre différemment ou peut ignorer un paramètre. La variation spécifique à l’instruction est décrite dans la documentation de l’instruction.

control [[text,]] id, x, y, width, height[[, style[[, extended-style]]]][, helpId]
[{ data-element-1 [, data-element-2 [,  . . . ]]}]

Texte

Texte à afficher avec le contrôle. Le texte est positionné dans le contrôle ou adjacent au contrôle.

Ce paramètre doit contenir zéro ou plusieurs caractères placés entre guillemets doubles (« ). Les chaînes sont automatiquement terminées par la valeur Null et converties en Unicode dans le fichier de ressources résultant.

Par défaut, les caractères répertoriés entre les guillemets doubles sont des caractères ANSI et les séquences d’échappement sont interprétées comme des séquences d’échappement d’octets. Si la chaîne est précédée du préfixe « L », la chaîne est une chaîne à caractères larges et les séquences d’échappement sont interprétées comme des séquences d’échappement de 2 octets qui spécifient des caractères Unicode. Si un guillemet double est requis dans le texte, vous devez inclure le guillemet double deux fois.

Un caractère ampersand (&) dans le texte indique que le caractère suivant est utilisé comme caractère mnémonique pour le contrôle. Lorsque le contrôle est affiché, l’ampersand n’est pas affiché, mais le caractère mnémonique est souligné. L’utilisateur peut choisir le contrôle en appuyant sur la touche correspondant au caractère mnémonique souligné. Pour utiliser l’esperluette comme caractère dans une chaîne, insérez deux ampersands (&&).

Id

Identificateur de contrôle. Cette valeur doit être un entier non signé 16 bits dans la plage 0 à 65 535 ou une expression arithmétique simple qui correspond à une valeur dans cette plage.

X

Coordonnée X du côté gauche du contrôle par rapport au côté gauche de la boîte de dialogue. Cette valeur doit être un entier non signé 16 bits dans la plage 0 à 65 535. La coordonnée est en unités de boîte de dialogue et est relative à l’origine de la boîte de dialogue, de la fenêtre ou du contrôle contenant le contrôle spécifié.

y

Coordonnée Y du côté supérieur du contrôle par rapport au haut de la boîte de dialogue. Cette valeur doit être un entier non signé 16 bits dans la plage 0 à 65 535. La coordonnée est en unités de boîte de dialogue par rapport à l’origine de la boîte de dialogue, de la fenêtre ou du contrôle contenant le contrôle spécifié.

Largeur

Largeur du contrôle. Cette valeur doit être un entier non signé 16 bits dans la plage 1 à 65 535. La largeur est en unités de 1/4 caractères.

Hauteur

Hauteur du contrôle. Cette valeur doit être un entier non signé 16 bits dans la plage 1 à 65 535. La hauteur est en unités de 1/8 caractères.

Style

Styles de contrôle. Utilisez l’opérateur OR au niveau du bit (|) pour combiner des styles. Pour plus d’informations, consultez Styles de fenêtre.

style étendu

Styles de fenêtre étendus. Vous devez spécifier le style pour spécifier le style étendu. Pour plus d’informations, consultez EXSTYLE.

helpId

Expression numérique indiquant l’ID utilisé pour identifier le contrôle pendant WM_HELP traitement.

controlData

Données spécifiques au contrôle pour le contrôle. Lorsqu’un dialogue est créé et qu’un contrôle de cette boîte de dialogue contenant des données spécifiques au contrôle est créé, un pointeur vers ces données est passé dans la procédure de fenêtre du contrôle via lParam du message WM_CREATE pour ce contrôle.

Notes

Les unités de dialogue horizontales représentent 1/4 de l’unité de largeur de base du dialogue. Les unités verticales représentent 1/8 de l’unité de hauteur de base du dialogue. Les unités de base de la boîte de dialogue actuelle sont calculées à partir de la hauteur et de la largeur de la police système actuelle. La fonction GetDialogBaseUnits retourne les unités de base de la boîte de dialogue en pixels. Les coordonnées sont relatives à l’origine de la boîte de dialogue.