CStatusBarCtrl::Create

BOOL Cre&ate ( DWORD dwStyle, const RECTamp ; Rect, CWnd * pParentWnd, UINT nID );

Valeur de retour

Différent de zéro en cas de succès ; sinon zéro.

Paramètres

dwStyle  ;  Spécifie le style du contrôle de barre de statut. Appliquer n'importe quelle combinaison de styles de contrôle barre statut au contrôle. Ce paramètre doit inclure le style WS_CHILD . Il devrait également inclure le style WS_VISIBLE . Consultez la section Remarques pour plus d'informations.

rect

Spécifie la taille et la position du contrôle de la barre de statut. Il peut être soit un objet CRect ou un structure RECT.

pParentWnd

Spécifie l'État présente la fenêtre parent du contrôle habituellement un CDialog. Il ne faut pas NULL.

nID

Spécifie l'ID du contrôle de barre de statut.

Remarques

Vous construisez une CStatusBarCtrl en deux étapes. Tout d'abord appeler le constructeur, puis appelez Create, qui crée le contrôle de barre d'État et l'attache à l'objet CStatusBarCtrl.

Le paramètre dwStyle peut avoir n'importe quelle combinaison des valeurs suivantes:

• CCS_BOTTOM  ;  Le contrôle se positionne au bas de la zone client de la fenêtre parente et définit la largeur est le même que le parent, la largeur de la fenêtre. Les contrôles de barre de statut ont ce style par défaut.
  
  
• CCS_&NODIVIDERnbsp ;  Empêche un clou de deux-pixel est dessiné en haut du contrôle.
  
  
• CCS_&NOHILITEnbsp ;  Empêche un clou d'un pixel est dessiné en haut du contrôle.
  
  
• CCS_&NOMOVEYnbsp ;  Amène le contrôle à redimensionner et à se déplacer horizontalement, mais pas verticalement, en réponse à un message WM_SIZE . Si le style CCS_NORESIZE est utilisé, ce style ne s'applique pas.
  
  
• CCS_&NOPARENTALIGNnbsp ;  Empêche le contrôle de passer automatiquement vers le haut ou le bas de la fenêtre parent. Au lieu de cela, le contrôle conserve sa position dans la fenêtre parente en dépit des changements de la taille de la fenêtre parente. Si le style CCS_TOP ou CCS_BOTTOM est aussi utilisé, la hauteur est ajustée à la valeur par défaut, mais la position et la largeur restent inchangés.
  
  
• CCS_&NORESIZEnbsp ;  Empêche le contrôle de l'utilisation de la largeur par défaut et la hauteur lors de la définition de sa taille initiale ou une nouvelle taille. Au lieu de cela, le contrôle utilise la largeur et la hauteur spécifiée dans la demande de création ou de dimensionnement.
  
  
• CCS_TOP  ;  Amène le contrôle à se positionner en haut de la zone client de la fenêtre parente et définit la largeur est le même que le parent, la largeur de la fenêtre.

La position par défaut d'une fenêtre de statut est au bas de la fenêtre parent, mais vous pouvez spécifier le style CCS_TOP pour la faire apparaître en haut de la zone client de la fenêtre parente. Vous pouvez spécifier le style SBARS_SIZEGRIP pour inclure une poignée de redimensionnement à l'extrémité droite de la fenêtre de statut. Combinant les styles CCS_TOP et SBARS_SIZEGRIP est déconseillé, car la poignée de dimensionnement qui en résulte n'est pas fonctionnelle, même si le système il puise dans la fenêtre de statut.

Aperçu CStatusBarCtrl |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CStatusBarCtrl::CStatusBarCtrl