Tutorial d'initiation
A la programmation avec l'API Windows

Chapitre 2

Les boîtes de dialogue

7. Le contrôle 'Progress bar'

Le contrôle 'Progress Bar' est l'un des plus simples à utiliser. Ses styles étant définis au niveau ressources, l'utilisation se borne à la définition de la position. Pour cela, il faut tout d'abord donner 2 valeurs numériques qui constituent le minimum et le maximum de la barre de progression. Une fois cela fait, il ne reste plus qu'à fournir une position courante.

Avant de pouvoir utiliser ce contrôle, il faut penser à l'initialiser. On doit placer en début de programme un appel à la fonction InitCommonControls() ou à la fonction InitCommonControlsEx(), de manière à forcer le chargement des Dlls permettant d'utiliser ce contrôle. L'appel à l'une de ces deux fonctions peut être fait à n'importe quel moment (mais avant d'utiliser le contrôle) et ne doit être fait qu'une seule fois. Si cet appel n'est pas fait, la boîte de dialogue de s'affichera pas.

Les styles pouvant être utilisés avec ce contrôle sont simples, ils sont donnés dans l'Annexe A.

Voici les messages utilisés pour commander ce contrôle :

PBM_SETRANGE permet de définir les valeurs numériques du minimum et du maximum pouvant être atteints. Les valeurs de cet intervalle, tout comme la position courante sont des entiers, il faut donc prévoir un intervalle assez large pour ne pas que l'on distingue de saccades lors de la progression. Cet intervalle doit donc être au moins de la taille (en pixels) de la barre. De manière générale, on peut opter pour un intervalle 0 - 1000.

PBM_SETPOS définit la position actuelle de progression. Cette valeur doit bien entendu être comprise dans l'intervalle fourni par le message PBM_SETRANGE.