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.