CHeaderCtrl::Create
Crea un controllo intestazione e lo collega a un oggetto CHeaderCtrl.
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID
);
Parametri
dwStyle
Specifica lo stile del controllo intestazione.Per una descrizione degli stili del controllo intestazione, vedere Stili del controllo intestazione in Windows SDK.rect
Specifica la dimensione e la posizione del controllo intestazione.Può essere un oggetto CRect o una struttura RECT.pParentWnd
Specifica la finestra padre del controllo intestazione, in genere CDialog.Non deve essere NULL.nID
Specifica l'id controllo intestazione
Valore restituito
Diverso da zero se l'inizializzazione riuscita; in caso contrario zero.
Note
Costruisce un oggetto CHeaderCtrl in due passaggi.Innanzitutto, chiamare il costruttore e quindi chiamare Crea, che crea il controllo intestazione e lo aggiunge all'oggetto CHeaderCtrl.
Oltre agli stili del controllo intestazione, è possibile utilizzare i seguenti stili di controlli comuni per determinare come il controllo intestazione posizionamento e viene ridimensionato (vedere Stili di controlli comuni per ulteriori informazioni):
CCS_BOTTOM genera il controllo per posizionarsi nella parte inferiore dell'area client della finestra padre e la larghezza per corrispondere alla larghezza della finestra padre.
CCS_NODIVIDER impedisce evidenziazione di due pixel da essere disegnato nella parte superiore del controllo.
CCS_NOMOVEY genera il controllo per il ridimensionamento orizzontale, ma non verticale e spostarsi, in risposta a un messaggio WM_SIZE.Se lo stile CCS_NORESIZE viene utilizzato, questo stile non viene applicato.i controlli intestazione hanno questo stile per impostazione predefinita.
CCS_NOPARENTALIGN impedisce il controllo viene automaticamente lo spostamento all'inizio o alla fine della finestra padre.Invece, il controllo tiene la relativa posizione nella finestra padre comporta modifiche alla dimensione della finestra padre.Se lo stile CCS_BOTTOM o CCS_TOP viene utilizzato, l'altezza viene adattata all'impostazione predefinita, ma la posizione e la larghezza rimangono invariate.
CCS_NORESIZE impedisce il controllo utilizzando la larghezza e l'altezza predefinita quando si imposta la dimensione iniziale o una nuova dimensione.Invece, il controllo utilizza la larghezza e l'altezza viene specificata la richiesta per la creazione o il ridimensionamento.
CCS_TOP genera il controllo per posizionarsi all'area client della finestra padre e la larghezza per corrispondere alla larghezza della finestra padre.
È anche possibile applicare gli stili la finestra a un controllo intestazione (vedere Stili della finestra per ulteriori informazioni):
WS_CHILD crea una finestra figlio.Non utilizzabile con lo stile WS_POPUP.
WS_VISIBLE crea una finestra che inizialmente è visibile.
WS_DISABLED crea una finestra che inizialmente è disabilitata.
WS_GROUP specifica il primo controllo di un gruppo di controlli in cui l'utente può spostarsi da un controllo al successivo con i tasti di direzione.Tutti i controlli definiti con lo stile WS_GROUP dopo il primo controllo appartengono allo stesso gruppo.Il controllo successivo alla fine dello stile WS_GROUP il gruppo e l'avvio di stile il gruppo successivo (ovvero un gruppo termina in cui inizia seguito).
WS_TABSTOP specifica uno di un numero illimitato di controlli da cui l'utente può spostarsi utilizzando il tasto TAB.Il tasto TAB sposta l'utente al controllo successivo specificato dallo stile WS_TABSTOP.
Se si desidera utilizzare gli stili estesi di windows con il controllo, chiamare CreateEx anziché Crea.
Esempio
// pParentWnd is a pointer to the parent window.
m_myHeaderCtrl.Create(WS_CHILD | WS_VISIBLE | HDS_HORZ,
CRect(10, 10, 600, 50), pParentWnd, 1);
Requisiti
Header: afxcmn.h