Udostępnij za pośrednictwem


CHeaderCtrl::Create

Tworzy formant nagłówka i dołącza go do CHeaderCtrl obiektu.

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

Parametry

  • dwStyle
    Określa styl nagłówka formantu.Opis nagłówka sterowania style, zobacz Style nagłówków sterowania w Windows SDK.

  • rect
    Określa rozmiar i położenie nagłówka formantu.Mogą być albo CRect obiektu lub RECT struktury.

  • pParentWnd
    Zazwyczaj określa okno nadrzędne nagłówka formantu, CDialog.Nie wolno NULL.

  • nID
    Określa identyfikator formantu nagłówka.

Wartość zwracana

Niezerowa, jeśli Inicjalizacja zakończyła się pomyślnie; zero w inny sposób.

Uwagi

Można skonstruować CHeaderCtrl obiektu w dwóch etapach.Po pierwsze, wywołanie konstruktora, a następnie wywołać Tworzenie, który tworzy nagłówka formantu i dołącza go do CHeaderCtrl obiektu.

Oprócz stylów formantu nagłówka można użyć następujących stylów wspólnej kontroli do pozycji i zmienia rozmiar samego nagłówka formantu (zobacz Wspólnych stylów formantu więcej informacji):

  • CCS_BOTTOMPowoduje, że formant umieścić się w dolnej części okna nadrzędnego obszaru klienckiego i ustawia szerokość był taki sam nadrzędny szerokości okna.

  • CCS_NODIVIDERWyróżnij dwie pikseli uniemożliwia rysowana w górnej części formantu.

  • CCS_NOMOVEYPowoduje, że formant Zmienianie rozmiaru i przenoszenie się poziomo, ale nie w pionie, w odpowiedzi na WM_SIZE wiadomości.Jeśli CCS_NORESIZE jest używany styl, styl ten nie ma zastosowania.Domyślnie nagłówek formanty mają ten styl.

  • CCS_NOPARENTALIGNFormant uniemożliwia automatyczne przeniesienie do góry lub u dołu okna nadrzędnego.Zamiast tego formant zachowuje swoje stanowisko w obrębie okna nadrzędnego, pomimo zmian do rozmiaru okna nadrzędnego.Jeśli CCS_TOP lub CCS_BOTTOM jest również używany styl, wysokość jest dopasowywana do domyślnie, ale położenie i szerokość pozostają niezmienione.

  • CCS_NORESIZEFormant zapobiega użyciu domyślną szerokość i wysokość, ustawiając jego początkowy rozmiar lub nowy rozmiar.Zamiast tego formantu używa szerokość i wysokość, określony w żądaniu utworzenia lub zmiany rozmiaru.

  • CCS_TOPPowoduje, że formant umieścić się w górnej części okna nadrzędnego obszaru klienckiego i ustawia szerokość był taki sam nadrzędny szerokości okna.

Następujące style okna można również stosować do nagłówka formantu (zobacz Style okna więcej informacji):

  • WS_CHILD tworzy okno podrzędne.Nie można używać z WS_POPUP styl.

  • WS_VISIBLE tworzy okno początkowo widoczny.

  • WS_DISABLED tworzy okno, która początkowo jest wyłączona.

  • WS_GROUP Określa pierwszy formant grupy formantów, w których użytkownik może przechodzić z jednego formantu w kolejnych za pomocą klawiszy strzałek.Wszystkie formanty zdefiniowana z WS_GROUP styl po pierwszej kontroli należą do tej samej grupy.Następny formant z WS_GROUP styl kończy się w grupie stylów i rozpoczyna następną grupę (czyli jedną grupę końce rozpoczęcia następnego).

  • WS_TABSTOP Określa jedną z dowolną liczbę formantów, które można przenieść użytkownika za pomocą klawisza TAB.Klawisz TAB przenosi użytkownika do następnego formantu określonej przez WS_TABSTOP styl.

Jeśli chcesz użyć stylów rozszerzonego systemu windows z formantu, wywołanie CreateEx zamiast Tworzenie.

Przykład

// pParentWnd is a pointer to the parent window.
m_myHeaderCtrl.Create(WS_CHILD | WS_VISIBLE | HDS_HORZ,
   CRect(10, 10, 600, 50), pParentWnd, 1);

Wymagania

Nagłówek: afxcmn.h

Zobacz też

Informacje

Klasa CHeaderCtrl

Wykres hierarchii

CHeaderCtrl::CHeaderCtrl