CStatusBar, classe

Article
06/10/2015

Une barre de contrôles avec une ligne de texte a sorti des volets, ou « indicateurs ».

class CStatusBar : public CControlBar

Membres

Constructeurs publics

Nom	Description
CStatusBar::CStatusBar	Construit un objet CStatusBar.

Méthodes publiques

Nom	Description
CStatusBar::CommandToIndex	Obtient l'index pour une application donnée d'indicateur
CStatusBar::Create	Crée la barre d'état, la attaché à l'objet d' CStatusBar , et définit la hauteur initiale de police et de barre.
CStatusBar::CreateEx	Crée un objet d' CStatusBar avec les styles supplémentaires pour l'objet incorporé d' CStatusBarCtrl .
CStatusBar::DrawItem	Appelé lorsqu'un aspect visuel s'aligne d'un contrôle de barre d'état owner draw.
CStatusBar::GetItemID	Obtient l'ID d'indicateur pour un index donné.
CStatusBar::GetItemRect	Obtient le rectangle d'affichage pour un index donné.
CStatusBar::GetPaneInfo	Obtient l'ID, le style, et la largeur des indicateurs pour un index donné.
CStatusBar::GetPaneStyle	Obtient le style des indicateurs pour un index donné.
CStatusBar::GetPaneText	Obtient le texte de l'indicateur pour un index donné.
CStatusBar::GetStatusBarCtrl	Autorise l'accès direct au contrôle commun sous-jacent.
CStatusBar::SetIndicators	Définit les ID des indicateurs.
CStatusBar::SetPaneInfo	Définit l'ID, le style, et la largeur des indicateurs pour un index donné.
CStatusBar::SetPaneStyle	Définit le style des indicateurs pour un index donné.
CStatusBar::SetPaneText	Définit le texte d'indicateur pour un index donné.

Notes

Les volets de sortie en général sont utilisés comme lignes de message et comme indicateurs. Les exemples incluent les lignes d'aide- message de menu qui présentent brièvement la commande de menu sélectionné et les indicateurs qui illustrent le mode du DÉFIL, VERR.NUM le, et les deux clés.

CStatusBar::GetStatusBarCtrl, une fonction membre nouvelle aux MFC 4,0, vous permet de tirer parti de la prise en charge de contrôles communs Windows à la personnalisation et de la fonctionnalité supplémentaire de barre d'état. Les fonctions membres d'CStatusBar vous fournissent plus de les fonctionnalités des contrôles communs Windows ; toutefois, lorsque vous appelez GetStatusBarCtrl, vous pouvez permettre à vos barres d'état bien plus les caractéristiques d'une barre d'état Windows 95/98. Lorsque vous appelez GetStatusBarCtrl, il retourne une référence à un objet d' CStatusBarCtrl . Consultez CStatusBarCtrl pour plus d'informations sur la conception de barres d'outils à des contrôles communs Windows. Pour plus d'informations générales sur les contrôles communs, consultez contrôles communs dans Kit de développement logiciel Windows.

L'infrastructure stocke les informations d'indicateur dans un tableau avec l'indicateur situé le plus à gauche à la position 0. Lorsque vous créez une barre d'état, utilisez un tableau d'ID de chaîne que l'infrastructure rapport avec les indicateurs correspondants. Vous pouvez ensuite utiliser un ID de chaîne ou un index pour accéder à un indicateur.

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

Pour créer une barre d'état, suivez ces étapes :

Construisez l'objet d' CStatusBar .
Appelez la fonction de Create (ou CreateEx) pour créer la fenêtre de barre d'état et pour la liaison à l'objet d' CStatusBar .
Appelez SetIndicators pour associer un ID de chaîne avec chaque indicateur.

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

Appel CWnd::SetWindowText pour mettre à jour le texte dans le volet 0 uniquement.
Appel CCmdUI::SetText dans le gestionnaire d' ON_UPDATE_COMMAND_UI de la barre d'état.
Appel SetPaneText pour mettre à jour le texte pour tout volet.

Appel SetPaneStyle pour mettre à jour le style d'un volet de barre d'état.

Pour plus d'informations sur l'utilisation CStatusBar, consultez l'article Implémentation de barre d'état dans MFC et note technique 31 : barres de contrôles.