Sdílet prostřednictvím

Ovládací prvek záhlaví

  • Článek

Tato část obsahuje informace o programovacích prvcích používaných s ovládacími prvky záhlaví.

Přehledy

Námět Obsah
o ovládacích prvcích záhlaví Ovládací prvek záhlaví je okno, které je obvykle umístěné nad sloupci textu nebo čísel. Obsahuje název pro každý sloupec a dá se rozdělit do částí.
pomocí ovládacích prvků záhlaví Toto téma obsahuje podrobnosti implementace a příklady kódu pro ovládací prvky hlaviček.

Makra

Námět Obsah
Header_ClearAllFilters Vymaže všechny filtry pro daný ovládací prvek záhlaví. Toto makro můžete použít nebo odeslat zprávu HDM_CLEARFILTER explicitně.
Header_ClearFilter Vymaže filtr pro daný ovládací prvek záhlaví. Toto makro můžete použít nebo odeslat zprávu HDM_CLEARFILTER explicitně.
Header_CreateDragImage Vytvoří průhlednou verzi obrázku položky v rámci existujícího ovládacího prvku záhlaví. Toto makro můžete použít nebo odeslat zprávu HDM_CREATEDRAGIMAGE explicitně.
Header_DeleteItem Odstraní položku z ovládacího prvku záhlaví. Toto makro můžete použít nebo odeslat zprávu HDM_DELETEITEM explicitně.
Header_EditFilter Přesune vstupní fokus do textového pole, když je fokus na tlačítku filtru.
Header_GetBitmapMargin Získá šířku okraje (v pixelech) rastrového obrázku v existujícím ovládacím prvku záhlaví. Toto makro můžete použít nebo odeslat zprávu HDM_GETBITMAPMARGIN explicitně.
Header_GetFocusedItem Získá položku v ovládacím prvku záhlaví, který má fokus. Použijte toto makro nebo odešlete zprávu HDM_GETFOCUSEDITEM explicitně.
Header_GetImageList Získá popisovač do seznamu obrázků, který byl nastaven pro existující ovládací prvek záhlaví. Toto makro můžete použít nebo odeslat zprávu HDM_GETIMAGELIST explicitně.
Header_GetItem Získá informace o položce v ovládacím prvku záhlaví. Toto makro můžete použít nebo odeslat zprávu HDM_GETITEM explicitně.
Header_GetItemCount Získá počet položek v ovládacím prvku záhlaví. Toto makro můžete použít nebo odeslat zprávu HDM_GETITEMCOUNT explicitně.
Header_GetItemDropDownRect Získá souřadnice rozevíracího tlačítka pro zadanou položku v ovládacím prvku záhlaví. Ovládací prvek záhlaví musí být typu HDF_SPLITBUTTON. Použijte toto makro nebo odešlete zprávu HDM_GETITEMDROPDOWNRECT explicitně.
Header_GetItemRect Získá ohraničující obdélník pro danou položku v ovládacím prvku záhlaví. Toto makro můžete použít nebo odeslat zprávu HDM_GETITEMRECT explicitně.
Header_GetOrderArray Získá aktuální pořadí položek zleva doprava v ovládacím prvku záhlaví. Toto makro můžete použít nebo odeslat zprávu HDM_GETORDERARRAY explicitně.
Header_GetOverflowRect Získá souřadnice oblasti přetečení rozevíracího seznamu pro zadaný ovládací prvek záhlaví. Ovládací prvek záhlaví musí být typu HDF_SPLITBUTTON. Použijte toto makro nebo explicitně odešlete zprávu HDM_GETOVERFLOWRECT.
Header_GetStateImageList Získá popisovač do seznamu obrázků, který byl nastaven pro existující stav řízení záhlaví.
Header_GetUnicodeFormat Získá příznak formátu znaku Unicode pro ovládací prvek. Toto makro můžete použít nebo odeslat zprávu HDM_GETUNICODEFORMAT explicitně.
Header_InsertItem Vloží novou položku do ovládacího prvku záhlaví. Toto makro můžete použít nebo odeslat zprávu HDM_INSERTITEM explicitně.
Header_Layout Načte správnou velikost a umístění ovládacího prvku záhlaví v nadřazené okně. Toto makro můžete použít nebo odeslat zprávu HDM_LAYOUT explicitně.
Header_OrderToIndex Načte hodnotu indexu pro položku na základě jejího pořadí v ovládacím prvku záhlaví. Toto makro můžete použít nebo odeslat zprávu HDM_ORDERTOINDEX explicitně.
Header_SetBitmapMargin Nastaví šířku okraje rastrového obrázku v existujícím ovládacím prvku záhlaví. Toto makro můžete použít nebo odeslat zprávu HDM_SETBITMAPMARGIN explicitně.
Header_SetFilterChangeTimeout Nastaví interval časového limitu mezi časem, kdy se změna provede v atributech filtru a zaúčtování oznámení HDN_FILTERCHANGE. Toto makro můžete použít nebo odeslat zprávu HDM_SETFILTERCHANGETIMEOUT explicitně.
Header_SetFocusedItem Nastaví fokus na zadanou položku v ovládacím prvku záhlaví. Toto makro použijte nebo odešlete zprávu HDM_SETFOCUSEDITEM explicitně.
Header_SetHotDivider Změní barvu rozdělovače mezi položkami záhlaví tak, aby označí cíl externí operace přetažení. Toto makro můžete použít nebo odeslat zprávu HDM_SETHOTDIVIDER explicitně.
Header_SetImageList Přiřadí seznam obrázků existujícímu ovládacímu prvku záhlaví. Toto makro můžete použít nebo odeslat zprávu HDM_SETIMAGELIST explicitně.
Header_SetItem Nastaví atributy zadané položky v ovládacím prvku záhlaví. Toto makro můžete použít nebo odeslat zprávu HDM_SETITEM explicitně.
Header_SetOrderArray Nastaví pořadí položek záhlaví zleva doprava. Toto makro můžete použít nebo odeslat zprávu HDM_SETORDERARRAY explicitně.
Header_SetStateImageList Přiřadí seznam obrázků existujícímu stavu ovládacího prvku záhlaví.
Header_SetUnicodeFormat Nastaví příznak formátu znaku UNICODE pro ovládací prvek. Tato zpráva umožňuje změnit znakovou sadu používanou ovládacím prvku za běhu, a nemusíte ho znovu vytvářet. Toto makro můžete použít nebo odeslat zprávu HDM_SETUNICODEFORMAT explicitně.

Zprávy

Námět Obsah
HDM_CLEARFILTER Vymaže filtr pro daný ovládací prvek záhlaví. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_ClearFilter.
HDM_CREATEDRAGIMAGE Vytvoří poloprůhlednou verzi obrázku položky, která se použije jako přetahování obrázku. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_CreateDragImage.
HDM_DELETEITEM Odstraní položku z ovládacího prvku záhlaví. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_DeleteItem.
HDM_EDITFILTER Přesune vstupní fokus do textového pole, když je fokus na tlačítku filtru.
HDM_GETBITMAPMARGIN Získá šířku rastrového okraje pro ovládací prvek záhlaví. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_GetBitmapMargin.
HDM_GETFOCUSEDITEM Získá položku v ovládacím prvku záhlaví, který má fokus. Odešlete tuto zprávu explicitně nebo pomocí makra Header_GetFocusedItem. Okno obdrží tuto zprávu prostřednictvím funkce WindowProc.
HDM_GETIMAGELIST Získá popisovač do seznamu obrázků, který byl nastaven pro existující ovládací prvek záhlaví. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_GetImageList nebo Header_GetStateImageList.
HDM_GETITEM Získá informace o položce v ovládacím prvku záhlaví. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_GetItem.
HDM_GETITEMCOUNT Získá počet položek v ovládacím prvku záhlaví. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_GetItemCount.
HDM_GETITEMDROPDOWNRECT Získá ohraničující obdélník rozděleného tlačítka pro položku záhlaví se stylem HDF_SPLITBUTTON. Odešlete tuto zprávu explicitně nebo pomocí makraHeader_GetItemDropDownRect.
HDM_GETITEMRECT Získá ohraničující obdélník pro danou položku v ovládacím prvku záhlaví. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_GetItemRect.
HDM_GETORDERARRAY Získá aktuální pořadí položek zleva doprava v ovládacím prvku záhlaví. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_GetOrderArray.
HDM_GETOVERFLOWRECT Získá ohraničující obdélník přetečení tlačítko, když je styl HDS_OVERFLOW nastaven na ovládacím prvku záhlaví a tlačítko přetečení je viditelné. Odešlete tuto zprávu explicitně nebo pomocí makraHeader_GetOverflowRect.
HDM_GETUNICODEFORMAT Získá příznak formátu znaku Unicode pro ovládací prvek. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_GetUnicodeFormat.
HDM_HITTEST Otestuje bod pro určení položky záhlaví, pokud existuje, je v zadaném bodě.
HDM_INSERTITEM Vloží novou položku do ovládacího prvku záhlaví. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_InsertItem.
HDM_LAYOUT Načte informace použité k nastavení velikosti a umístění ovládacího prvku záhlaví v cílovém obdélníku nadřazeného okna. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_Layout.
HDM_ORDERTOINDEX Načte hodnotu indexu pro položku na základě jejího pořadí v ovládacím prvku záhlaví. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_OrderToIndex.
HDM_SETBITMAPMARGIN Nastaví šířku okraje zadaného v pixelech rastrového obrázku v existujícím ovládacím prvku záhlaví. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_SetBitmapMargin.
HDM_SETFILTERCHANGETIMEOUT Nastaví interval časového limitu mezi časem, kdy se změna provede v atributech filtru a zaúčtování oznámení HDN_FILTERCHANGE. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_SetFilterChangeTimeout.
HDM_SETFOCUSEDITEM Nastaví fokus na zadanou položku v ovládacím prvku záhlaví. Odešlete tuto zprávu explicitně nebo pomocí makra Header_SetFocusedItem.
HDM_SETHOTDIVIDER Změní barvu rozdělovače mezi položkami záhlaví tak, aby označí cíl externí operace přetažení. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_SetHotDivider.
HDM_SETIMAGELIST Přiřadí seznam obrázků existujícímu ovládacímu prvku záhlaví. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_SetImageList nebo Header_SetStateImageList.
HDM_SETITEM Nastaví atributy zadané položky v ovládacím prvku záhlaví. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_SetItem.
HDM_SETORDERARRAY Nastaví pořadí položek záhlaví zleva doprava. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_SetOrderArray.
HDM_SETUNICODEFORMAT Nastaví příznak formátu znaku UNICODE pro ovládací prvek. Tato zpráva umožňuje změnit znakovou sadu používanou ovládacím prvku za běhu, a nemusíte ho znovu vytvářet. Tuto zprávu můžete odeslat explicitně nebo použít makro Header_SetUnicodeFormat.
HDM_TRANSLATEACCELERATOR Není implementováno.

Upozornění

Námět Obsah
HDN_BEGINDRAG Odesláno ovládacím prvkem záhlaví, když operace přetažení začala na některé z jejích položek. Tento kód oznámení se odesílá pouze ovládacími prvky záhlaví, které jsou nastavené na styl HDS_DRAGDROP. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
HDN_BEGINFILTEREDIT Upozorní nadřazené okno ovládacího prvku záhlaví na zahájení úprav filtru. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
HDN_BEGINTRACK Upozorní nadřazené okno ovládacího prvku záhlaví, že uživatel začal přetahovat rozdělovač v ovládacím prvku (to znamená, že uživatel stiskl levé tlačítko myši, zatímco kurzor myši je na rozdělovači v ovládacím prvku záhlaví). Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
HDN_DIVIDERDBLCLICK Upozorní nadřazené okno ovládacího prvku záhlaví, že uživatel poklikáním na oblast rozdělovače ovládacího prvku. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
HDN_DROPDOWN Po kliknutí na šipku rozevíracího seznamu v ovládacím prvku záhlaví se odešle ovládací prvek záhlaví do nadřazeného ovládacího prvku. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
HDN_ENDDRAG Odesláno ovládacím prvkem záhlaví, když operace přetažení skončila na jedné z jejích položek. Tento kód oznámení se odešle jako WM_NOTIFY zpráva. Toto oznámení odesílají jenom ovládací prvky záhlaví, které jsou nastavené na styl HDS_DRAGDROP.
HDN_ENDFILTEREDIT Upozorní nadřazené okno ovládacího prvku záhlaví, že úpravy filtru skončily. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
HDN_ENDTRACK Upozorní nadřazené okno ovládacího prvku záhlaví, že uživatel dokončil přetahování oddělovače. Tento kód oznámení odeslaný ve formě WM_NOTIFY zprávy.
HDN_FILTERBTNCLICK Upozorní nadřazené okno ovládacího prvku záhlaví po kliknutí na tlačítko filtru nebo v reakci na zprávu HDM_SETITEM.
HDN_FILTERCHANGE Upozorní nadřazené okno ovládacího prvku záhlaví, že se mění nebo upravuje atributy filtru ovládacího prvku záhlaví.
HDN_GETDISPINFO Odesláno vlastníkovi ovládacího prvku záhlaví, pokud ovládací prvek potřebuje informace o položce záhlaví zpětného volání. Tento kód oznámení se odešle jako WM_NOTIFY zpráva.
HDN_ITEMCHANGED Upozorní nadřazené okno ovládacího prvku záhlaví, že se změnily atributy položky záhlaví. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
HDN_ITEMCHANGING Upozorní nadřazené okno ovládacího prvku záhlaví, že se mají změnit atributy položky záhlaví. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
HDN_ITEMCLICK Upozorní nadřazené okno ovládacího prvku záhlaví, že uživatel na ovládací prvek klikl. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
HDN_ITEMDBLCLICK Upozorní nadřazené okno ovládacího prvku záhlaví, že uživatel poklikli na ovládací prvek. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. Toto oznámení odesílají jenom ovládací prvky záhlaví nastavené na styl HDS_BUTTONS.
HDN_ITEMKEYDOWN Upozorní nadřazené okno ovládacího prvku záhlaví, že byla stisknuta klávesa s vybranou položkou. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
HDN_ITEMSTATEICONCLICK Upozorní nadřazené okno ovládacího prvku záhlaví, že uživatel klikl na ikonu stavu položky.
HDN_OVERFLOWCLICK Po kliknutí na tlačítko přetečení záhlaví se odešle ovládací prvek záhlaví do nadřazeného objektu. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
HDN_TRACK Upozorní nadřazené okno ovládacího prvku záhlaví, že uživatel přetahuje oddělovač v ovládacím prvku záhlaví. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
NM_CUSTOMDRAW (záhlaví) Odesláno ovládacím prvkem záhlaví, které informuje nadřazené okno o operacích kreslení. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
NM_RCLICK (záhlaví) Upozorní nadřazené okno ovládacího prvku stromového zobrazení, že uživatel v ovládacím prvku kliknul na pravé tlačítko myši. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
NM_RELEASEDCAPTURE (záhlaví) Upozorní nadřazené okno ovládacího prvku záhlaví, že ovládací prvek uvolní zachycení myši. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.

Konstanty

Námět Obsah
styly ovládacího prvku záhlaví Ovládací prvky záhlaví mají řadu stylů popsaných v této části, které určují vzhled a chování ovládacího prvku. Při vytváření ovládacího prvku záhlaví nastavíte počáteční styly.