Contrôle PushButton

Le contrôle PushButton affiche un bouton push de base, également appelé bouton de commande.

Les contrôles PushButton ne peuvent pas être utilisés pour publier un Objet IgnoreChange ControlEvent, SelectionDescription ControlEvent, SelectionSize ControlEvent, SelectionPath ControlEvent, SelectionPathOnControlEvent, SelectionNoItems ControlEvent, ActionText ControlEvent, ActionData ControlEvent, SetProgress ControlEvent ou TimeRemaining ControlEvent.

Vous pouvez utiliser les attributs suivants avec ce contrôle. Pour modifier la valeur d’un attribut à l’aide d’un événement, abonnez-vous au 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 Événement.

Identificateur d’attribut Bit hexadécimal Description
Position Position du contrôle dans la boîte de dialogue. Entrez la largeur, la hauteur et les coordonnées du contrôle dans le coin gauche du contrôle dans les colonnes Width, Height, X et Y de la table Control. Utilisez des unités d’installation pour la longueur et la distance.
Text 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 de caractères affichés avec {\style} ou {&style}. Où le 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 sera utilisée.
Pour spécifier une icône ou une image bitmap stockée dans la table Binaire, entrez la clé primaire de l’enregistrement de l’image à partir de la colonne Nom de la table Binaire dans la colonne Texte de l’enregistrement de la table Contrôle pour le contrôle.
Visible 0x00000000 0x00000001
Contrôle masqué. Contrôle visible.
Incluez ce bit dans le mot de bits de la colonne Attributs dans la table Contrôle 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.
Enabled 0x00000000 0x00000002
Contrôle dans un état désactivé. Contrôler dans un état activé.
Incluez ce bit dans la colonne Attributs du contrôle 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 une apparence 3D enfoncée.
Incluez ces bits dans le mot de bits dans la colonne Attributs de la table Contrôle.
RTLRO 0x00000000 0x00000020
Le texte du contrôle s’affiche dans l’ordre de lecture gauche à droite. Le texte du contrôle s’affiche dans l’ordre de lecture de droite à gauche.
Bitmap 0x00000000 0x00040000
Le texte du contrôle est spécifié dans la colonne Texte de la table Contrôle. Le bouton a le style BS_BITMAP, le texte dans le contrôle est remplacé par une image bitmap. La colonne Texte de la table Contrôle est utilisée comme clé étrangère à la table binaire.
Incluez ce bit dans le mot bit dans la colonne Attributs du contrôle.
Ne définissez pas les bits de style Icon et Bitmap simultanément. Le bouton ne peut pas contenir à la fois une image bitmap et du texte.
Pour définir la police et le style de police d’une chaîne de texte, préfixez la chaîne de caractères affichés avec {\style} ou {&style}. Où le 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 sera utilisée.
Contrôle d’icône 0x00000000 0x00080000
Le texte du contrôle est spécifié dans la colonne Texte de la table Contrôle. Le bouton a le style BS_ICON, le texte dans le contrôle est remplacé par une image d’icône. La colonne Texte de la table Contrôle est utilisée comme clé étrangère à la table binaire.
Incluez ce bit dans le mot bit dans la colonne Attributs du contrôle.
Ne définissez pas simultanément les bits Icon et Bitmap. Le bouton ne peut pas contenir à la fois une image d’icône et du texte.
Pour définir la police et le style de police d’une chaîne de texte, préfixez la chaîne de caractères affichés avec {\style} ou {&style}. Où le 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 sera utilisée.
Correction de la taille 0x00000000 0x00100000
Étirez l’image d’icône pour ajuster le contrôle. Rognez ou centrez l’image d’icône dans le contrôle.
Incluez ce bit dans le mot de bits de la colonne Attributs de la table BBControl ou de la table Control.
IconSize 0x00000000 0x00200000
0x00400000
0x00600000
Charge la première image. Charge la première image 16x16.
Charge la première image 32x32.
Charge la première image 48x48.
Un fichier d’icône peut contenir différentes images de taille de la même icône. Inclure la valeur du mot de bits approprié dans la colonne Attributs de la table Contrôle
Si ces bits ne sont pas définis, le programme d’installation ignore l’attribut FixedSize et l’image est étirée pour ajuster le rectangle de contrôle. Si les bits IconSize et les bits FixedSize sont définis, une image inférieure au contrôle est centrée et une image est plus grande que le contrôle qu’il est réduit à ajuster.
ElevationShield 0x00000000 0x00800000
L’apparence de pushbutton est déterminée par les autres attributs d’icône. Ajoute l’icône d’élévation de contrôle de compte d’utilisateur (UAC) au contrôle pushbutton.

 

Remarques

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