CStatusBar

Un objet CStatusBar est une barre de contrôle avec une rangée de vitres de sortie de texte, ou « indicateurs ». Les volets de sortie sont couramment utilisés comme lignes de message et comme indicateurs de l'État. Les lignes de message d'aide menu d'expliquer brièvement la commande de menu sélectionné et les indicateurs qui montrent l'état de l'arrêt DÉFIL, VERR NUM et autres touches sont des exemples.

CStatusBar::GetStatusBarCtrl, une fonction membre de MFC 4.0, vous permet de profiter de l'appui du contrôle commun Windows pour la personnalisation de la barre statut et des fonctionnalités supplémentaires. Fonctions de membres CStatusBar vous donnent la plupart des fonctionnalités des contrôles communs Windows ; Toutefois, lorsque vous appelez GetStatusBarCtrl, vous pouvez donner vos barres d'État encore plus les caractéristiques d'une barre d'État de Windows 95. Lorsque vous appelez GetStatusBarCtrl, il retourne une référence à un objet CStatusBarCtrl . Voir CStatusBarCtrl pour plus d'informations sur la conception des barres d'outils à l'aide des contrôles communs Windows. Pour des informations plus générales sur les contrôles communs, voir Contrôles communs dans la référence du programmeur SDK de Windows 95.

Le cadre stocke les informations de l'indicateur dans un tableau avec l'indicateur le plus à gauche à la position 0. Lorsque vous créez une barre d'État, vous utilisez un tableau de chaîne ID que le cadre associe les indicateurs correspondants. Vous pouvez ensuite utiliser un ID de chaîne ou d'un index à un indicateur d'accès.

Par défaut, le premier indicateur est « élastique »: il occupe la longueur de la barre d'État non utilisée par les autres volets de l'indicateur, ainsi que les autres volets sont alignés à droite.

Pour créer une barre d'État, procédez comme suit:

  1. Construire l'objet CStatusBar.

  2. Appelez la fonction Create (ou CreateEx) pour créer la fenêtre de la barre d'État et le joindre à l'objet CStatusBar.

  3. Appelez SetIndicators pour associer un ID de chaîne à chaque indicateur.

Il existe trois façons de mettre à jour le texte dans un volet de barre d'État:

  1. Appelez CWnd::SetWindowText pour mettre à jour le texte dans le volet 0 seulement.

  2. Appeler CCmdUI::SetText dans le gestionnaire de la barre d'état ON_UPDATE_COMMAND_UI.

  3. Appelez CStatusBar pour mettre à jour le texte d'un volet.

Appelez SetPaneStyle pour mettre à jour le style d'un volet de barre d'État.

Pour plus d'informations sur l'utilisation de CStatusBar, consultez l'article Barres d'État dans le Guide du programmeur Visual C++ et technique Note 31, barres de contrôle.

# include lt;afxext.h>

Membres de la classe |  ; Classe de base | Graphique de la hiérarchie

Écha&ntillons denbsp ; Exemple MFC CTRLBARS | MFC exemple DLGCBR32

Voir aussi  ;CStatusBarCtrl, CControlBar, CWnd::SetWindowText, CStatusBar::SetIndicators

Index