Partager via


PushButton, contrôle

Le contrôle PushButton affiche un bouton de commande de base.

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

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
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.
Texte Cet attribut de contrôle peut spécifier le texte affiché par le contrôle, une image stockée dans la table Binary 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 Text de la table Control. 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 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 de la colonne Name de la table Binary dans la colonne Text 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 au moment 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.
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.
Bitmap 0x00000000 0x00040000
Le texte du contrôle est spécifié dans la colonne Text de la table Control. Le bouton a le style BS_BITMAP, le texte du contrôle est remplacé par une image bitmap. La colonne Text de la table Control est utilisée comme clé étrangère de la table Binary.
Incluez ce bit dans le mot de bits de la colonne Attributes de la table Control.
Ne définissez pas simultanément les bits de style Icon et Bitmap. 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 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 style de texte valide, cette police est utilisée.
Icon, contrôle 0x00000000 0x00080000
Le texte du contrôle est spécifié dans la colonne Text de la table Control. Le bouton a le style BS_ICON, le texte du contrôle est remplacé par une image d’icône. La colonne Text de la table Control est utilisée comme clé étrangère de la table Binary.
Incluez ce bit dans le mot de bits de la colonne Attributes de la table Control.
Ne définissez pas les bits Icon et Bitmap simultanément. 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 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 sera utilisée.
FixedSize 0x00000000 0x00100000
Étire l’image d’icône pour qu’elle s’adapte au contrôle. Rogne ou centre l’image d’icône dans le contrôle.
Incluez ce bit dans le mot de bits de la colonne Attributes dans la table BBControl ou 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 des images de tailles différentes pour la même icône. Incluez la valeur du mot de bits approprié dans la colonne Attributes de la table Control
Si ces bits ne sont pas définis, le programme d’installation ignore l’attribut FixedSize et l’image sera étirée pour s’adapter au rectangle du contrôle. Si les bits IconSize et FixedSize sont définis, une image plus petite que le contrôle sera centrée et une image plus grande sera réduite pour s’adapter.
ElevationShield 0x00000000 0x00800000
L’apparence du bouton de commande est déterminée par les autres attributs d’icône. Ajoute l’icône d’élévation (icône de bouclier) Contrôle de compte d’utilisateur (UAC) au contrôle PushButton.

 

Notes

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.