CHeaderCtrl::Create
Crée un contrôle header et l'attache à un objet d' CHeaderCtrl .
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID
);
Paramètres
dwStyle
Spécifie le style du contrôle header. Pour une description des styles de contrôle header, consultez styles de contrôle header dans Kit de développement logiciel Windows.rect
Spécifie la taille et la position du contrôle header. Ce peut être un objet de CRect ou une structure de RECT .pParentWnd
Spécifie la fenêtre parente du contrôle header, généralement CDialog. Il ne doit pas être NULL.nID
Spécifie l'ID du contrôle header
Valeur de retour
Une valeur différente de zéro si l'initialisation a abouti ; sinon zéro.
Notes
Vous construisez un objet d' CHeaderCtrl en deux étapes. D'abord, appelez le constructeur puis appelez Créer, qui crée le contrôle header et l'attache à l'objet d' CHeaderCtrl .
Outre les styles de contrôle header, vous pouvez utiliser les styles suivants de contrôles communs pour déterminer comment le contrôle header positionne et se redimensionne (consultez Styles de contrôles communs pour plus d'informations) :
CCS_BOTTOM fait se déplacer le contrôle en bas de la zone cliente de la fenêtre parente et définit la largeur pour être identiques la largeur de la fenêtre parente.
CCS_NODIVIDER empêché une surbrillance à deux pixel d'être dessiné en haut du contrôle.
CCS_NOMOVEY fait redimensionner et se déplacer le contrôle horizontalement, verticalement mais pas, en réponse à un message d' WM_SIZE . Si le style d' CCS_NORESIZE est utilisé, ce style ne s'applique pas. Les contrôles header ont ce style par défaut.
CCS_NOPARENTALIGN empêché le contrôle de déplacer automatiquement en haut ou en bas de la fenêtre parente. À la place, le contrôle conserve sa position dans la fenêtre parente en dépit de les modifications apportées à la taille de la fenêtre parente. Si le style d' CCS_TOP ou d' CCS_BOTTOM est également utilisé, la hauteur est définie à la valeur par défaut, mais la position et la largeur restent inchangées.
CCS_NORESIZE empêché le contrôle d'utiliser la largeur et la hauteur par défaut en définissant sa taille d'origine ou une nouvelle taille. À la place, le contrôle utilise la largeur et la hauteur spécifiée dans la requête de la création ou de dimensionnement.
CCS_TOP fait se déplacer le contrôle en haut de la zone cliente de la fenêtre parente et définit la largeur pour être identiques la largeur de la fenêtre parente.
Vous pouvez également appliquer des styles de fenêtre suivants à un contrôle header (consultez styles de fenêtre pour plus d'informations) :
WS_CHILD crée une fenêtre enfant. Ne peut pas être utilisé avec le style d' WS_POPUP .
WS_VISIBLE crée une fenêtre qui est initialement visible.
WS_DISABLED crée une fenêtre qui est initialement désactivée.
WS_GROUP spécifie le premier contrôle d'un groupe de contrôles dans lesquels l'utilisateur peut déplacer d'un contrôle à l'autre avec les touches de direction. Tout contrôle défini avec le style de WS_GROUP après le premier contrôle appartiennent au même groupe. Le contrôle suivant avec le style de WS_GROUP termine le groupe de style et met démarrer le groupe (autrement dit, termine une de groupe où le prochain démarrage).
WS_TABSTOP spécifie un d'un certain nombre de contrôles dans lesquels l'utilisateur peut déplacer à l'aide de la touche TAB. La touche TAB déplace l'utilisateur au contrôle suivant spécifié par le style de WS_TABSTOP .
Si vous souhaitez utiliser des styles de fenêtre étendus avec votre contrôle, appelez CreateEx au lieu de Créer.
Exemple
// pParentWnd is a pointer to the parent window.
m_myHeaderCtrl.Create(WS_CHILD | WS_VISIBLE | HDS_HORZ,
CRect(10, 10, 600, 50), pParentWnd, 1);
Configuration requise
Header: afxcmn.h