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

Chapitre 2

Les boîtes de dialogue

4. Le contrôle 'Check Box'

Le contrôle 'Check Box' fait lui aussi partie de l'un des plus simples. Il peut contenir trois états, coché, non coché ou indéterminé. On peut lui attribuer différents styles qui modifient son apparence et parfois son fonctionnement. Par défaut, ce contrôle ne peut être que dans deux états, coché ou non coché. En modifiant le style on peut permettre à l'utilisateur de spécifier un troisième état, indéterminé, qui correspond à une case cochée mais grisée. Voici une liste des styles principaux pouvant être appliqués à ce contrôle (les styles modifiant l'apparence graphique du contrôle ne sont pas traités ici). Pour une liste exhaustive des différents types consultez l'annexe A.

Tri-state [BS_3STATE] [BS_AUTO3STATE] : le contrôle peut prendre 3 états au lieu de deux.

Auto : [BS_AUTO3STATE] [BS_AUTOCHECKBOX] : permet de créer un contrôle dont l'état est modifié automatiquement lorsque l'utilisateur l'utilise. Si ce style n'est pas activé, la boîte de dialogue reçoit un message WM_COMMAND et doit elle-même modifier l'état du contrôle.

Comme on pouvait s'y attendre, il suffit de deux fonctions pour le manipuler, une pour modifier son état, et l'autre pour récupérer son état.

CheckDlgButton() : permet de modifier l'état du contrôle. Il suffit de spécifier la boite de dialogue qui le contient ainsi que son identifiant et un paramètre commandant l'état du contrôle. Les trois états possibles sont BST_CHECKED, BST_INDETERMINATE et BST_UNCHECKED. Le contrôle sera redessiné automatiquement, c'est à dire que lorsque la fonction retournera, l'état graphique du contrôle aura été modifié.

IsDlgButtonChecked() : permet de récupérer l'état du contrôle. Cette fonction retourne un entier non signé qui peut prendre une des trois valeurs présentées ci-dessus.

L'utilisation de contrôles 'Check box' se résume donc à peu de choses. Elle pourra être mise en parallèle avec les contrôles 'Radio buttons', qui fonctionnement de manière similaire, mais avec un système de groupes.