Partager via


CStatusBarCtrl::Create

Crée un contrôle de barre d'état et l'attache à un objet d' CStatusBarCtrl .

virtual BOOL Create(
   DWORD dwStyle,
   const RECT& rect,
   CWnd* pParentWnd,
   UINT nID 
);

Paramètres

  • dwStyle
    Spécifie le style du contrôle de barre d'état.Appliquez une combinaison des styles de contrôle de barre d'état répertoriés dans Styles de contrôles communs dans Kit de développement logiciel Windows.Ce paramètre doit inclure le style de WS_CHILD .Il doit également inclure le style de WS_VISIBLE .

  • rect
    Spécifie la taille et la position du contrôle de barre d'état.Ce peut être un objet de CRect ou une structure de RECT .

  • pParentWnd
    Spécifie la fenêtre parente du contrôle de barre d'état, généralement CDialog.Il ne doit pas être NULL.

  • nID
    Spécifie l'ID du contrôle de barre d'état

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon zéro.

Notes

Vous construisez CStatusBarCtrl en deux étapes.D'abord, appelez le constructeur, puis appelez Créer, qui crée le contrôle de barre d'état et l'attache à l'objet d' CStatusBarCtrl .

L'emplacement par défaut d'une fenêtre d'état est le long de le bas de la fenêtre parente, mais vous pouvez spécifier le style d' CCS_TOP pour le faire apparaître dans la partie supérieure de la zone cliente de la fenêtre parente.Vous pouvez spécifier le style de SBARS_SIZEGRIP pour inclure une poignée de dimensionnement à l'extrémité droite de la fenêtre de mode.Combinaison CCS_TOP et les styles de SBARS_SIZEGRIP n'est pas recommandée, car la poignée de dimensionnement résultant n'est pas fonctionnelle bien que le système la trace dans la fenêtre de mode.

Pour créer une barre d'état et de styles de fenêtre étendus, appelez CStatusBarCtrl::CreateEx au lieu de Créer.

Exemple

VERIFY(m_wndSBC.Create(WS_CHILD|WS_VISIBLE|CCS_BOTTOM|SBARS_SIZEGRIP,
   CRect(0,0,0,0), this, IDC_STATUSBARCTRL));

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

Classe de CStatusBarCtrl

Graphique de la hiérarchie

CStatusBarCtrl::CStatusBarCtrl