ProgressBar, contrôle

Le contrôle ProgressBar affiche un graphique à barres qui change de longueur à mesure qu’il reçoit des messages de progression. Ce contrôle s’abonne à SetProgress ControlEvent. Il peut s’abonner à un ControlEvent nommé d’après l’action analysée.

Pour plus d’informations, consultez Création d’un contrôle ProgressBar et Ajout d’actions personnalisées à ProgressBar.

Attributs de contrôle

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.
Progression		Cet attribut spécifie la quantité de ProgressBar remplie. L’attribut est composé de deux entiers et d’une chaîne. Le premier champ entier est le nombre actuel de cycles de progression et le deuxième champ entier est le nombre maximal par défaut de cycles de progression (1024). Le troisième champ est une chaîne qui est le nom de l’action en cours. Si le nombre actuel de cycles de progression est supérieur à la valeur maximale, le programme d’installation le remplace par le nombre maximal. Cet attribut est défini et modifié par setProgress ControlEvent. Vous devez abonner le contrôle à cet événement dans la table EventMapping en entrant SetProgress dans la colonne Événement et Progression dans la colonne Attribut.
Texte		Texte affiché par le contrôle. 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 est utilisée.
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.
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.
Progress95	0x00000000 0x00010000	Barre de progression dessinée sous forme de barre continue. Barre de progression dessinée sous la forme d’une série de rectangles. Incluez ces bits dans le mot de bits dans la colonne Attributs de la table Contrôle.

 

Notes

Ce contrôle peut être créé à partir de la classe PROGRESS_CLASS à l’aide de la fonction CreateWindowEx. Il présente les styles WS_CHILD et WS_GROUP.