TN031 : Barres de contrôles

Cette note décrit les classes de barre de contrôle dans MFC : CControlBar, CStatusBar, CToolBar, CDialogBar et CDockBar.

CControlBar

A ControlBar est une CWndclasse dérivée qui :

• Est aligné en haut ou en bas d’une fenêtre frame.

• Peut contenir des éléments enfants qui sont soit des contrôles basés sur HWND (par exemple CDialogBar), soit des éléments non basés surHWND (par exemple CToolBarou CStatusBar).

Les barres de contrôles prennent en charge les styles supplémentaires suivants :

• CBRS_TOP (valeur par défaut) épinglez la barre de contrôle en haut.

• CBRS_BOTTOM épingler la barre de contrôle au bas.

• CBRS_NOALIGN Ne repositionnez pas la barre de contrôle lorsque le parent est redimensionné.

Les classes dérivées de CControlBar fournissent des implémentations plus intéressantes :

• CStatusBar Une barre d’état. Les éléments sont des volets de barre d’état contenant du texte.

• CToolBar Une barre d’outils. Les éléments sont des boutons de bitmap alignés sur une ligne.

• CDialogBar Un cadre de barre d’outils contenant des commandes Windows standard (créés à partir d’une ressource de modèle de boîte de dialogue).

• CDockBar Zone d’ancrage généralisée pour d’autres CControlBar objets dérivés. Les variables et fonctions membres spécifiques disponibles dans cette classe sont susceptibles de changer dans les versions ultérieures.

L’ensemble des fenêtres et des objets des barres de contrôles seront des fenêtres enfants d’une fenêtre de frame parente. Ils sont généralement ajoutés comme frères à la zone cliente du frame (par exemple, un client MDI ou une vue). L’ID de fenêtre enfant d’une barre de contrôle est important. La disposition par défaut de la barre de contrôle fonctionne uniquement pour les barres de contrôles dont l’ID est compris dans la plage allant de AFX_IDW_CONTROLBAR_FIRST à AFX_IDW_CONTROLBAR_LAST. Notez que même s’il existe une plage de 256 ID de barres de contrôles, les 32 premiers sont spéciaux car ils sont directement pris en charge par l’architecture d’aperçu avant impression.

La classe CControlBar fournit une implémentation standard pour :

• L’alignement de la barre de contrôle en haut, en bas ou de chaque côté du frame.

• L’allocation des tableaux d’éléments de contrôle.

• La prise en charge de l’implémentation des classes dérivées.

Les objets de barres de contrôles C++ sont généralement incorporés comme membres d’une classe dérivée de CFrameWnd et sont nettoyés quand le HWND parent et l’objet sont détruits. Si vous devez allouer un objet de barre de contrôle sur le tas, vous pouvez simplement définir le membre m_bAutoDestruct sur TRUE pour appeler la barre delete this; de contrôle lorsque celle-ci HWND est détruite.

// CMyControlBar is derived from CControlBar
BOOL CMyControlBar::Create(CWnd* pParentWnd,
    DWORD dwStyle,
    UINT nID)
{
    m_dwStyle = dwStyle;

.
.
.
}

Algorithme de disposition de barre de contrôle

L’algorithme de disposition de barre de contrôle est très simple. La fenêtre frame envoie un message WM_SIZEPARENT à tous les enfants compris dans la plage de barre de contrôle. Un pointeur vers le rectangle client du parent est passé en même temps que ce message. Ce message est envoyé aux éléments enfants dans l’ordre de plan. Les enfants de la barre de contrôle utilisent ces informations pour se positionner et pour réduire la taille de la zone cliente du parent. Le rectangle final conservé pour la zone cliente normale (moins les barres de contrôles) sert à positionner la fenêtre cliente principale (généralement un client MDI, une vue ou une fenêtre fractionnée).

Pour plus d’informations, consultez CWnd::RepositionBars et CFrameWnd::RecalcLayout .

Les messages Windows privés MFC, y compris WM_SIZEPARENT, sont documentés dans la note technique 24.

CStatusBar

Une barre d’état est une barre de contrôle qui comporte une ligne de volets de sortie de texte. Il existe deux manières courantes d’utiliser des volets de sortie de texte :

• Comme ligne de message

  (par exemple, la ligne de message d’aide du menu standard). Ils sont généralement accessibles par un index de base 0

• Comme indicateurs d’état

  (par exemple, les indicateurs MAJ, NUM et DÉFIL). Ils sont généralement accessibles par ID de chaîne/commande.

La police de la barre d’état est 10 points MS Sans Serif (dictée par le Guide de conception d’application d’interface Windows ou par la meilleure correspondance du mappeur de police pour une police proportionnelle Swiss 10 points). Sur certaines versions de Windows, comme la version japonaise, les polices sélectionnées sont différentes.

Les couleurs utilisées dans la barre d’état sont également conformes à la recommandation du Guide de conception d’application d’interface Windows. Ces couleurs ne sont pas codées en dur. Elles sont modifiées de manière dynamique en réponse à la personnalisation par l’utilisateur dans le Panneau de configuration.

Prise en charge de CCmdUI pour CStatusBar

La façon dont les indicateurs sont généralement mis à jour est par le biais du mécanisme de ON_UPDATE_COMMAND_UI. Lors de l’inactivité, la barre d’état appelle le gestionnaire ON_UPDATE_COMMAND_UI avec l’ID de chaîne du volet d’indicateur.

Le gestionnaire ON_UPDATE_COMMAND_UI peut appeler :

• Enable: pour activer ou désactiver le volet. Un volet désactivé est identique à un volet activé, sauf que le texte est invisible (autrement dit, l’indicateur de texte est désactivé).

• SetText: pour modifier le texte. Faites attention si vous utilisez cette option, car le volet n’est pas redimensionné automatiquement.

Pour plus d’informations sur les API de création et de personnalisation , consultez la classe CStatusBar dans la Référence de la bibliothèque de classes CStatusBar . La plupart des opérations de personnalisation des barres d’état doivent être effectuées avant que la barre d’état soit initialement rendue visible.

La barre d’état prend en charge un seul volet extensible, généralement le premier volet. La taille de ce volet est vraiment une taille minimale. Si la taille de la barre d’état est supérieure à la taille minimale de tous les volets, toute largeur supplémentaire est accordée au volet extensible. L’application par défaut avec une barre d’état comporte des indicateurs alignés à droite pour MAJ, NUM et DÉFIL, puisque le premier volet est extensible.

CToolBar

Une barre d’outils est une barre de contrôle comportant une ligne de boutons bitmap pouvant inclure des séparateurs. Deux styles de boutons sont pris en charge : les boutons de commande et les cases à cocher. Les fonctionnalités de groupe radio peuvent être créées avec des boutons de boîte de case activée et des ON_UPDATE_COMMAND_UI.

Tous les boutons de bitmap dans la barre d’outils proviennent d’une seule bitmap. Cette bitmap doit contenir une image ou un glyphe pour chaque bouton. En général, l’ordre des images/glyphes dans la bitmap est le même que celui dans lequel ils seront dessinés à l’écran. (Cela peut être modifié à l’aide des API de personnalisation.)

Chaque bouton doit avoir la même taille. La valeur par défaut est la taille standard de 24x22 pixels. Chaque image/glyphe doit avoir la même taille et doit être côte à côte dans la bitmap. La taille d’image/glyphe par défaut est de 16x15 pixels. Ainsi, pour une barre d’outils avec 10 boutons (de taille standard), vous avez besoin d’une bitmap de 160 pixels de large sur 15 pixels de haut.

Chaque bouton a une seule et unique image/glyphe. Les différents états et styles des boutons (par exemple enfoncé, activé, désactivé et indéterminé) sont générés par un algorithme à partir de cette image/glyphe. En théorie, vous pouvez utiliser n’importe quelle bitmap ou DIB en couleur. L’algorithme permettant de générer les différents états des boutons fonctionne mieux si l’image d’origine est en nuances de gris. Pour obtenir des exemples, consultez les boutons de barres d’outils standard et les images clipart de boutons de barres d’outils fournis dans l’exemple général MFC CLIPART .

Les couleurs utilisées dans la barre d’outils sont également conformes à la recommandation du Guide de conception d’application d’interface Windows. Ces couleurs ne sont pas codées en dur. Elles sont modifiées de manière dynamique en réponse à la personnalisation par l’utilisateur dans le Panneau de configuration.

De plus, les boutons bitmap de la barre d’outils sont recoloriés comme s’il s’agissait de contrôles de boutons Windows standard. Ce recoloriage a lieu quand la bitmap est chargée à partir de la ressource et en réponse à une modification des couleurs système suite à une personnalisation par l’utilisateur dans le Panneau de configuration. Les couleurs suivantes dans une bitmap de barre d’outils sont recoloriées automatiquement. Utilisez-les avec précaution. Si vous ne souhaitez pas qu’une partie de votre bitmap soit recoloriée, utilisez une couleur qui se rapproche de l’une des valeurs RVB mappées. Le mappage est effectué en fonction des valeurs RVB exactes.

Pour plus d’informations sur les API de création et de personnalisation , consultez la classe CToolBar dans la Référence de la bibliothèque de classes CToolBar . La plupart des opérations de personnalisation des barres d’outils doivent être effectuées avant que la barre d’outils soit initialement rendue visible.

Vous pouvez utiliser les API de personnalisation pour ajuster les ID de boutons, les styles, la largeur d’espacement et l’image/le glyphe utilisé(e) pour les boutons. Par défaut, vous n’êtes pas obligé d’utiliser ces API.

Prise en charge de CCmdUI pour CToolBar

La façon dont les boutons de barre d’outils sont toujours mis à jour est via le mécanisme de ON_UPDATE_COMMAND_UI. Au moment de l’inactivité, la barre d’outils appelle le gestionnaire ON_UPDATE_COMMAND_UI avec l’ID de commande de ce bouton. ON_UPDATE_COMMAND_UI n’est pas appelé pour les séparateurs, mais il est appelé pour les boutons pushbuttons et case activée boîte.

Le gestionnaire ON_UPDATE_COMMAND_UI peut appeler :

• Enable: pour activer ou désactiver le bouton. Cela fonctionne pareillement pour les boutons de commande et les cases à cocher.

• SetCheck: pour définir l’état d’activation d’un bouton. Si vous appelez cette fonction pour un bouton de barre d’outils, il est converti en case à cocher. SetCheck prend un paramètre qui peut être 0 (désactivé), 1 (activé) ou 2 (indéterminé)

• SetRadio: forme abrégée de SetCheck.

Les boutons de case à cocher sont des boutons de case à cocher « AUTO ». Autrement dit, quand l’utilisateur appuie dessus, ils changent d’état immédiatement. « Activé » correspond à l’état enfoncé. L’interface utilisateur n’intègre aucun moyen de faire basculer un bouton à l’état « indéterminé ». Vous devez le faire par le biais du code.

Les API de personnalisation vous permettent de modifier l’état d’un bouton de barre d’outils donné, de préférence vous devez modifier ces états dans le gestionnaire ON_UPDATE_COMMAND_UI pour la commande que représente le bouton de barre d’outils. N’oubliez pas que le traitement inactif modifie l’état des boutons de barre d’outils avec le gestionnaire ON_UPDATE_COMMAND_UI, de sorte que les modifications apportées à ces états par le biais de SetButtonStyle peuvent être perdues après l’inactivité suivante.

Les boutons de barre d’outils envoient des messages WM_COMMAND tels que des boutons normaux ou des éléments de menu et sont normalement gérés par un gestionnaire de ON_COMMAND dans la même classe qui fournit le gestionnaire ON_UPDATE_COMMAND_UI.

Quatre styles de boutons de barre d’outils (valeurs TBBS_) sont utilisés pour les états d’affichage :

• TBBS_CHECKED : La case à cocher est actuellement activée.

• TBBS_INDETERMINATE : La case à cocher est actuellement indéterminée.

• TBBS_DISABLED : Le bouton est actuellement désactivé.

• TBBS_PRESSED : Le bouton est actuellement enfoncé.

Les six styles de bouton officiels du Guide de conception d’application d’interface Windows sont représentés par les valeurs TBBS suivantes :

• Activé = 0

• Souris vers le bas = ToBS_PRESSED (| tout autre style)

• Désactivé = TBBS_DISABLED

• Enfoncé = TBBS_CHECKED

• Désactivé = ToBS_CHECKED | ToBS_DISABLED

• Indéterminé = TBBS_INDETERMINATE

CDialogBar

Une barre de boîte de dialogue est une barre de contrôle qui contient des commandes Windows standard. Elle agit comme une boîte de dialogue car elle contient les contrôles et prend en charge la tabulation entre eux. Elle agit également comme une boîte de dialogue car elle utilise un modèle de boîte de dialogue pour représenter la barre.

Un CDialogBar est utilisé pour la barre d’outils Aperçu avant impression, qui contient des contrôles de commande standard.

Utiliser un CDialogBar revient à utiliser un CFormView. Vous devez définir un modèle de boîte de dialogue pour la barre de boîte de dialogue et supprimer tous les styles à l’exception de WS_CHILD. Notez que la boîte de dialogue ne doit pas être visible.

Les notifications de contrôle pour un CDialogBar sont envoyés au parent de la barre de contrôle (tout comme des boutons de barre d’outils).

Prise en charge de CCmdUI pour CDialogBar

Les boutons de barre de dialogue doivent être mis à jour via le mécanisme de gestionnaire ON_UPDATE_COMMAND_UI. Au moment d’inactivité, la barre de dialogue appelle le gestionnaire ON_UPDATE_COMMAND_UI avec l’ID de commande de tous les boutons qui ont un ID >= 0x8000 (autrement dit, dans la plage d’ID de commande).

Le gestionnaire ON_UPDATE_COMMAND_UI peut appeler :

• Enable : pour activer ou désactiver le bouton.

• SetText : pour modifier le texte du bouton.

Vous pouvez effectuer une personnalisation par le biais des API du gestionnaire de fenêtre standard.

Voir aussi

Notes techniques par numéro
Notes techniques par catégorie