Udostępnij za pośrednictwem

Kontrolka nagłówka

  • Artykuł

Ta sekcja zawiera informacje o elementach programowania używanych z kontrolkami nagłówka.

Przeglądy

Temat Treść
informacje o kontrolkach nagłówka Kontrolka nagłówka to okno, które zwykle znajduje się powyżej kolumn tekstowych lub liczbowych. Zawiera tytuł dla każdej kolumny i można go podzielić na części.
przy użyciu kontrolek nagłówka Ten temat zawiera szczegóły implementacji i przykłady kodu dla kontrolek nagłówka.

Makra

Temat Treść
Header_ClearAllFilters Czyści wszystkie filtry dla danej kontrolki nagłówka. Tego makra można użyć lub wysłać jawnie komunikat HDM_CLEARFILTER.
Header_ClearFilter Czyści filtr dla danej kontrolki nagłówka. Tego makra można użyć lub wysłać jawnie komunikat HDM_CLEARFILTER.
Header_CreateDragImage Tworzy przezroczystą wersję obrazu elementu w istniejącej kontrolce nagłówka. Tego makra można użyć lub wysłać jawnie komunikat HDM_CREATEDRAGIMAGE.
Header_DeleteItem Usuwa element z kontrolki nagłówka. Tego makra można użyć lub jawnie wysłać komunikat HDM_DELETEITEM.
Header_EditFilter Przenosi fokus wejściowy do pola edycji, gdy przycisk filtru ma fokus.
Header_GetBitmapMargin Pobiera szerokość marginesu (w pikselach) mapy bitowej w istniejącej kontrolce nagłówka. Tego makra można użyć lub wysłać jawnie komunikat HDM_GETBITMAPMARGIN.
Header_GetFocusedItem Pobiera element w kontrolce nagłówka, która ma fokus. Użyj tego makra lub wyślij jawnie komunikat HDM_GETFOCUSEDITEM.
Header_GetImageList Pobiera dojście do listy obrazów, która została ustawiona dla istniejącej kontrolki nagłówka. Tego makra można użyć lub wysłać jawnie komunikat HDM_GETIMAGELIST.
Header_GetItem Pobiera informacje o elemencie w kontrolce nagłówka. Tego makra można użyć lub jawnie wysłać komunikat HDM_GETITEM.
Header_GetItemCount Pobiera liczbę elementów w kontrolce nagłówka. Tego makra można użyć lub wysłać jawnie komunikat HDM_GETITEMCOUNT.
Header_GetItemDropDownRect Pobiera współrzędne przycisku listy rozwijanej dla określonego elementu w kontrolce nagłówka. Kontrolka nagłówka musi być typu HDF_SPLITBUTTON. Użyj tego makra lub wyślij jawnie komunikat HDM_GETITEMDROPDOWNRECT.
Header_GetItemRect Pobiera prostokąt ograniczenia dla danego elementu w kontrolce nagłówka. Tego makra można użyć lub jawnie wysłać komunikat HDM_GETITEMRECT.
Header_GetOrderArray Pobiera bieżącą kolejność od lewej do prawej elementów w kontrolce nagłówka. Tego makra można użyć lub jawnie wysłać komunikat HDM_GETORDERARRAY.
Header_GetOverflowRect Pobiera współrzędne obszaru przepełnienia listy rozwijanej dla określonej kontrolki nagłówka. Kontrolka nagłówka musi być typu HDF_SPLITBUTTON. Użyj tego makra lub wyślij jawnie komunikat HDM_GETOVERFLOWRECT.
Header_GetStateImageList Pobiera dojście do listy obrazów, która została ustawiona dla istniejącego stanu kontrolki nagłówka.
Header_GetUnicodeFormat Pobiera flagę formatu znaków Unicode dla kontrolki. Tego makra można użyć lub jawnie wysłać komunikat HDM_GETUNICODEFORMAT.
Header_InsertItem Wstawia nowy element do kontrolki nagłówka. Tego makra można użyć lub wysłać jawnie komunikat HDM_INSERTITEM.
Header_Layout Pobiera prawidłowy rozmiar i położenie kontrolki nagłówka w oknie nadrzędnym. Tego makra można użyć lub jawnie wysłać komunikat HDM_LAYOUT.
Header_OrderToIndex Pobiera wartość indeksu dla elementu na podstawie jego kolejności w kontrolce nagłówka. Tego makra można użyć lub jawnie wysłać komunikat HDM_ORDERTOINDEX.
Header_SetBitmapMargin Ustawia szerokość marginesu dla mapy bitowej w istniejącej kontrolce nagłówka. Tego makra można użyć lub wysłać jawnie komunikat HDM_SETBITMAPMARGIN.
Header_SetFilterChangeTimeout Ustawia interwał limitu czasu między czasem zmiany w atrybutach filtru a publikowaniem powiadomienia HDN_FILTERCHANGE. Tego makra można użyć lub wysłać jawnie komunikat HDM_SETFILTERCHANGETIMEOUT.
Header_SetFocusedItem Ustawia fokus na określony element w kontrolce nagłówka. Użyj tego makra lub wyślij jawnie komunikat HDM_SETFOCUSEDITEM.
Header_SetHotDivider Zmienia kolor dzielenia między elementami nagłówka, aby wskazać miejsce docelowe operacji przeciągania i upuszczania zewnętrznego. Tego makra można użyć lub wysłać jawnie komunikat HDM_SETHOTDIVIDER.
Header_SetImageList Przypisuje listę obrazów do istniejącej kontrolki nagłówka. Tego makra można użyć lub wysłać jawnie komunikat HDM_SETIMAGELIST.
Header_SetItem Ustawia atrybuty określonego elementu w kontrolce nagłówka. Tego makra można użyć lub jawnie wysłać komunikat HDM_SETITEM.
Header_SetOrderArray Ustawia kolejność od lewej do prawej elementów nagłówka. Tego makra można użyć lub wysłać jawnie komunikat HDM_SETORDERARRAY.
Header_SetStateImageList Przypisuje listę obrazów do istniejącego stanu kontrolki nagłówka.
Header_SetUnicodeFormat Ustawia flagę formatu znaków UNICODE dla kontrolki. Ten komunikat umożliwia zmianę zestawu znaków używanego przez kontrolkę w czasie wykonywania zamiast konieczności ponownego tworzenia kontrolki. Tego makra można użyć lub wysłać jawnie komunikat HDM_SETUNICODEFORMAT.

Wiadomości

Temat Treść
HDM_CLEARFILTER Czyści filtr dla danej kontrolki nagłówka. Tę wiadomość można wysłać jawnie lub użyć makra Header_ClearFilter.
HDM_CREATEDRAGIMAGE Tworzy półprzezroczystą wersję obrazu elementu do użycia jako obraz przeciągania. Tę wiadomość można wysłać jawnie lub użyć makra Header_CreateDragImage.
HDM_DELETEITEM Usuwa element z kontrolki nagłówka. Tę wiadomość można wysłać jawnie lub użyć makra Header_DeleteItem.
HDM_EDITFILTER Przenosi fokus wejściowy do pola edycji, gdy przycisk filtru ma fokus.
HDM_GETBITMAPMARGIN Pobiera szerokość marginesu mapy bitowej dla kontrolki nagłówka. Tę wiadomość można wysłać jawnie lub użyć makra Header_GetBitmapMargin.
HDM_GETFOCUSEDITEM Pobiera element w kontrolce nagłówka, która ma fokus. Wyślij tę wiadomość jawnie lub przy użyciu makra Header_GetFocusedItem. Okno odbiera ten komunikat za pośrednictwem funkcji WindowProc.
HDM_GETIMAGELIST Pobiera dojście do listy obrazów, która została ustawiona dla istniejącej kontrolki nagłówka. Tę wiadomość można wysłać jawnie lub użyć makra Header_GetImageList lub Header_GetStateImageList.
HDM_GETITEM Pobiera informacje o elemencie w kontrolce nagłówka. Tę wiadomość można wysłać jawnie lub użyć makra Header_GetItem.
HDM_GETITEMCOUNT Pobiera liczbę elementów w kontrolce nagłówka. Tę wiadomość można wysłać jawnie lub użyć makra Header_GetItemCount.
HDM_GETITEMDROPDOWNRECT Pobiera prostokąt ograniczenia przycisku podziału dla elementu nagłówka z HDF_SPLITBUTTON stylu. Wyślij tę wiadomość jawnie lub przy użyciu makraHeader_GetItemDropDownRect.
HDM_GETITEMRECT Pobiera prostokąt ograniczenia dla danego elementu w kontrolce nagłówka. Tę wiadomość można wysłać jawnie lub użyć makra Header_GetItemRect.
HDM_GETORDERARRAY Pobiera bieżącą kolejność od lewej do prawej elementów w kontrolce nagłówka. Tę wiadomość można wysłać jawnie lub użyć makra Header_GetOrderArray.
HDM_GETOVERFLOWRECT Pobiera prostokąt ograniczenia przycisku przepełnienia, gdy styl HDS_OVERFLOW jest ustawiony na kontrolce nagłówka, a przycisk przepełnienia jest widoczny. Wyślij tę wiadomość jawnie lub przy użyciu makraHeader_GetOverflowRect.
HDM_GETUNICODEFORMAT Pobiera flagę formatu znaków Unicode dla kontrolki. Tę wiadomość można wysłać jawnie lub użyć makra Header_GetUnicodeFormat.
HDM_HITTEST Testuje punkt w celu określenia, który element nagłówka, jeśli istnieje, znajduje się w określonym punkcie.
HDM_INSERTITEM Wstawia nowy element do kontrolki nagłówka. Tę wiadomość można wysłać jawnie lub użyć makra Header_InsertItem.
HDM_LAYOUT Pobiera informacje używane do ustawiania rozmiaru i położenia kontrolki nagłówka w prostokątze docelowym okna nadrzędnego. Tę wiadomość można wysłać jawnie lub użyć makra Header_Layout.
HDM_ORDERTOINDEX Pobiera wartość indeksu dla elementu na podstawie jego kolejności w kontrolce nagłówka. Tę wiadomość można wysłać jawnie lub użyć makra Header_OrderToIndex.
HDM_SETBITMAPMARGIN Ustawia szerokość marginesu określonego w pikselach mapy bitowej w istniejącej kontrolce nagłówka. Tę wiadomość można wysłać jawnie lub użyć makra Header_SetBitmapMargin.
HDM_SETFILTERCHANGETIMEOUT Ustawia interwał limitu czasu między czasem zmiany w atrybutach filtru a publikowaniem powiadomienia HDN_FILTERCHANGE. Tę wiadomość można wysłać jawnie lub użyć makra Header_SetFilterChangeTimeout.
HDM_SETFOCUSEDITEM Ustawia fokus na określony element w kontrolce nagłówka. Wyślij tę wiadomość jawnie lub przy użyciu makra Header_SetFocusedItem.
HDM_SETHOTDIVIDER Zmienia kolor dzielenia między elementami nagłówka, aby wskazać miejsce docelowe operacji przeciągania i upuszczania zewnętrznego. Tę wiadomość można wysłać jawnie lub użyć makra Header_SetHotDivider.
HDM_SETIMAGELIST Przypisuje listę obrazów do istniejącej kontrolki nagłówka. Tę wiadomość można wysłać jawnie lub użyć makra Header_SetImageList lub Header_SetStateImageList.
HDM_SETITEM Ustawia atrybuty określonego elementu w kontrolce nagłówka. Tę wiadomość można wysłać jawnie lub użyć makra Header_SetItem.
HDM_SETORDERARRAY Ustawia kolejność od lewej do prawej elementów nagłówka. Tę wiadomość można wysłać jawnie lub użyć makra Header_SetOrderArray.
HDM_SETUNICODEFORMAT Ustawia flagę formatu znaków UNICODE dla kontrolki. Ten komunikat umożliwia zmianę zestawu znaków używanego przez kontrolkę w czasie wykonywania zamiast konieczności ponownego tworzenia kontrolki. Tę wiadomość można wysłać jawnie lub użyć makra Header_SetUnicodeFormat.
HDM_TRANSLATEACCELERATOR Nie zaimplementowano.

Powiadomienia

Temat Treść
HDN_BEGINDRAG Wysłane przez kontrolkę nagłówka, gdy operacja przeciągania rozpoczęła się na jednym z jego elementów. Ten kod powiadomienia jest wysyłany tylko przez kontrolki nagłówka ustawione na styl HDS_DRAGDROP. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY.
HDN_BEGINFILTEREDIT Powiadamia okno nadrzędne kontrolki nagłówka o rozpoczęciu edycji filtru. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY.
HDN_BEGINTRACK Powiadamia okno nadrzędne kontrolki nagłówka, że użytkownik rozpoczął przeciąganie dzielenia w kontrolce (czyli użytkownik nacisnął lewy przycisk myszy, gdy kursor myszy znajduje się na dzielniku w kontrolce nagłówka). Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY.
HDN_DIVIDERDBLCLICK Powiadamia okno nadrzędne kontrolki nagłówka, że użytkownik dwukrotnie kliknął obszar dzielenia kontrolki. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY.
HDN_DROPDOWN Wysłane przez kontrolkę nagłówka do elementu nadrzędnego po kliknięciu strzałki listy rozwijanej w kontrolce nagłówka. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY.
HDN_ENDDRAG Wysłane przez kontrolkę nagłówka, gdy operacja przeciągania zakończyła się na jednym z jego elementów. Ten kod powiadomienia jest wysyłany jako komunikat WM_NOTIFY. Powiadomienie wysyła tylko kontrolki nagłówka ustawione na styl HDS_DRAGDROP.
HDN_ENDFILTEREDIT Powiadamia okno nadrzędne kontrolki nagłówka o zakończeniu edycji filtru. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY.
HDN_ENDTRACK Powiadamia nadrzędne okno kontrolki nagłówka, że użytkownik zakończył przeciąganie dzielenia. Ten kod powiadomienia wysłany w postaci komunikatu WM_NOTIFY.
HDN_FILTERBTNCLICK Powiadamia okno nadrzędne kontrolki nagłówka, gdy przycisk filtru jest klikany lub w odpowiedzi na komunikat HDM_SETITEM.
HDN_FILTERCHANGE Powiadamia okno nadrzędne kontrolki nagłówka, że atrybuty filtru kontrolki nagłówka są zmieniane lub edytowane.
HDN_GETDISPINFO Wysłane do właściciela kontrolki nagłówka, gdy kontrolka potrzebuje informacji o elemencie nagłówka wywołania zwrotnego. Ten kod powiadomienia jest wysyłany jako komunikat WM_NOTIFY.
HDN_ITEMCHANGED Powiadamia okno nadrzędne kontrolki nagłówka o zmianie atrybutów elementu nagłówka. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY.
HDN_ITEMCHANGING Powiadamia okno nadrzędne kontrolki nagłówka, że atrybuty elementu nagłówka zostaną zmienione. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY.
HDN_ITEMCLICK Powiadamia okno nadrzędne kontrolki nagłówka, że użytkownik kliknął kontrolkę. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY.
HDN_ITEMDBLCLICK Powiadamia okno nadrzędne kontrolki nagłówka, że użytkownik dwukrotnie kliknął kontrolkę. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY. Powiadomienie wysyła tylko kontrolki nagłówka ustawione na styl HDS_BUTTONS.
HDN_ITEMKEYDOWN Powiadamia okno nadrzędne kontrolki nagłówka o naciśnięciu z wybranym elementem. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY.
HDN_ITEMSTATEICONCLICK Powiadamia okno nadrzędne kontrolki nagłówka, że użytkownik kliknął ikonę stanu elementu.
HDN_OVERFLOWCLICK Wysłane przez kontrolkę nagłówka do elementu nadrzędnego po kliknięciu przycisku przepełnienia nagłówka. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY.
HDN_TRACK Powiadamia okno nadrzędne kontrolki nagłówka, że użytkownik przeciąga element dzielący w kontrolce nagłówka. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY.
NM_CUSTOMDRAW (nagłówek) Wysłane przez kontrolkę nagłówka w celu powiadomienia okna nadrzędnego o operacjach rysowania. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY.
NM_RCLICK (nagłówek) Powiadamia okno nadrzędne kontrolki widoku drzewa, że użytkownik kliknął prawy przycisk myszy w kontrolce. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY.
NM_RELEASEDCAPTURE (nagłówek) Powiadamia nadrzędne okno kontrolki nagłówka, że kontrolka zwalnia przechwytywanie myszy. Ten kod powiadomienia jest wysyłany w postaci komunikatu WM_NOTIFY.

Stałe

Temat Treść
style kontrolek nagłówka Kontrolki nagłówka mają wiele stylów opisanych w tej sekcji, które określają wygląd i zachowanie kontrolki. Podczas tworzenia kontrolki nagłówka ustawia się style początkowe.