Partager via


Classe de CStatusBar

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

class CStatusBar : public CControlBar

Membres

fha3tfk7.collapse_all(fr-fr,VS.110).gifConstructeurs publics

Nom

Description

CStatusBar::CStatusBar

Construit un objet CStatusBar.

fha3tfk7.collapse_all(fr-fr,VS.110).gifMé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 :

  1. Construisez l'objet d' CStatusBar .

  2. 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 .

  3. 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 :

  1. Appel CWnd::SetWindowText pour mettre à jour le texte dans le volet 0 uniquement.

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

  3. 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.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CControlBar

CStatusBar

Configuration requise

Header: afxext.h

Voir aussi

Référence

Classe de CControlBar

Graphique de la hiérarchie

Classe de CStatusBarCtrl

Classe de CControlBar

CWnd::SetWindowText

CStatusBar::SetIndicators

Concepts

CTRLBARS exemple MFC

MFC exemple DLGCBR32