Fejléc vezérlőelem
Ez a szakasz az élőfej-vezérlőkkel használt programozási elemekről tartalmaz információkat.
Áttekintés
Téma | Tartalomjegyzék |
---|---|
A Fejlécvezérlők | Az élőfej-vezérlők általában szöveg- vagy számoszlopok felett elhelyezett ablak. Minden oszlophoz tartalmaz egy címet, és részekre osztható. |
Fejlécvezérlők használata | Ez a témakör a fejlécvezérlők implementálási részleteit és kód példáit ismerteti. |
Makrók
Téma | Tartalomjegyzék |
---|---|
Header_ClearAllFilters | Törli az adott fejlécvezérlő összes szűrőjének törlését. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_CLEARFILTER üzenetet. |
Header_ClearFilter | Törli egy adott fejlécvezérlő szűrőjének törlését. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_CLEARFILTER üzenetet. |
Header_CreateDragImage | Egy elemkép transzparens verzióját hozza létre egy meglévő fejlécvezérlőn belül. Ezt a makrót használhatja, vagy kifejezetten elküldheti a HDM_CREATEDRAGIMAGE üzenetet. |
Header_DeleteItem | Töröl egy elemet egy fejlécvezérlőből. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_DELETEITEM üzenetet. |
Header_EditFilter | Áthelyezi a bemeneti fókuszt a szerkesztési mezőbe, ha egy szűrőgombon van a fókusz. |
Header_GetBitmapMargin | Lekéri a bitkép margójának szélességét (képpontban) egy meglévő fejlécvezérlőben. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_GETBITMAPMARGIN üzenetet. |
Header_GetFocusedItem | Lekéri az elemet egy fejléc vezérlőelemben, amely a fókuszt tartalmazza. Használja ezt a makrót, vagy küldje el kifejezetten a HDM_GETFOCUSEDITEM üzenetet. |
Header_GetImageList | Lekéri a fogópontot a meglévő fejlécvezérlőhöz beállított képlistához. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_GETIMAGELIST üzenetet. |
Header_GetItem | Beolvashatja az élőfej vezérlőelem egyik eleméről szóló információkat. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_GETITEM üzenetet. |
Header_GetItemCount | Lekéri a fejlécvezérlő elemeinek számát. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_GETITEMCOUNT üzenetet. |
Header_GetItemDropDownRect | Lekéri a fejléc vezérlőelem egy adott eleméhez tartozó legördülő gomb koordinátáit. A fejléc vezérlőelemnek HDF_SPLITBUTTON típusúnak kell lennie. Használja ezt a makrót, vagy küldje el kifejezetten a HDM_GETITEMDROPDOWNRECT üzenetet. |
Header_GetItemRect | Lekéri egy adott elem határolókeretét egy fejlécvezérlőben. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_GETITEMRECT üzenetet. |
Header_GetOrderArray | Lekéri a fejléc vezérlőelem elemeinek aktuális balról jobbra sorrendjét. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_GETORDERARRAY üzenetet. |
Header_GetOverflowRect | Lekéri egy adott fejlécvezérlő legördülő túlcsordulási területének koordinátáit. A fejléc vezérlőelemnek HDF_SPLITBUTTON típusúnak kell lennie. Használja ezt a makrót, vagy küldje el kifejezetten a HDM_GETOVERFLOWRECT üzenetet. |
Header_GetStateImageList | Lekéri a fogópontot a meglévő fejlécvezérlő állapothoz beállított képlistához. |
Header_GetUnicodeFormat | Lekéri a vezérlő Unicode-karakterformázási jelzőt. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_GETUNICODEFORMAT üzenetet. |
Header_InsertItem | Új elemet szúr be egy fejlécvezérlőbe. Ezt a makrót használhatja, vagy kifejezetten elküldheti a HDM_INSERTITEM üzenetet. |
Header_Layout | Lekéri a fejlécvezérlő megfelelő méretét és pozícióját a szülőablakban. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_LAYOUT üzenetet. |
Header_OrderToIndex | Lekéri egy elem indexértékét a fejléc vezérlőelemben lévő sorrendje alapján. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_ORDERTOINDEX üzenetet. |
Header_SetBitmapMargin | Egy meglévő fejlécvezérlő bitképének margójának szélességét állítja be. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_SETBITMAPMARGIN üzenetet. |
Header_SetFilterChangeTimeout | Beállítja az időtúllépési időközt a szűrőattribútumokban a módosítás időpontja és egy HDN_FILTERCHANGE értesítés közzététele között. Ezt a makrót használhatja, vagy kifejezetten elküldheti a HDM_SETFILTERCHANGETIMEOUT üzenetet. |
Header_SetFocusedItem | A fókuszt egy fejlécvezérlő megadott elemére állítja. Használja ezt a makrót, vagy küldje el kifejezetten a HDM_SETFOCUSEDITEM üzenetet. |
Header_SetHotDivider | A fejlécelemek közötti elválasztó színének módosítása külső húzási művelet céljának jelzésére. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_SETHOTDIVIDER üzenetet. |
Header_SetImageList | Képlistát rendel egy meglévő fejlécvezérlőhöz. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_SETIMAGELIST üzenetet. |
Header_SetItem | Beállítja a megadott elem attribútumait egy fejlécvezérlőben. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_SETITEM üzenetet. |
Header_SetOrderArray | A fejlécelemek balról jobbra sorrendjét állítja be. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_SETORDERARRAY üzenetet. |
Header_SetStateImageList | Képlistát rendel egy meglévő fejlécvezérlő állapothoz. |
Header_SetUnicodeFormat | Beállítja a unicode karakterformátum jelzőt a vezérlőelemhez. Ez az üzenet lehetővé teszi, hogy a vezérlő által használt karakterkészletet futásidőben módosítsa ahelyett, hogy újra létre kellene hoznia a vezérlőt. Használhatja ezt a makrót, vagy kifejezetten elküldheti a HDM_SETUNICODEFORMAT üzenetet. |
Üzenetek
Téma | Tartalomjegyzék |
---|---|
HDM_CLEARFILTER | Törli egy adott fejlécvezérlő szűrőjének törlését. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_ClearFilter makrót. |
HDM_CREATEDRAGIMAGE | Egy elem képének félig transzparens verzióját hozza létre húzási képként való használatra. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_CreateDragImage makrót. |
HDM_DELETEITEM | Töröl egy elemet egy fejlécvezérlőből. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_DeleteItem makrót. |
HDM_EDITFILTER | Áthelyezi a bemeneti fókuszt a szerkesztési mezőbe, ha egy szűrőgombon van a fókusz. |
HDM_GETBITMAPMARGIN | Lekéri az élőfej-vezérlő bitképmargójának szélességét. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_GetBitmapMargin makrót. |
HDM_GETFOCUSEDITEM | Lekéri az elemet egy fejléc vezérlőelemben, amely a fókuszt tartalmazza. Küldje el ezt az üzenetet explicit módon vagy a Header_GetFocusedItem makró használatával. Az ablak a WindowProc függvényen keresztül kapja meg ezt az üzenetet. |
HDM_GETIMAGELIST | Lekéri a fogópontot a meglévő fejlécvezérlőhöz beállított képlistához. Ezt az üzenetet kifejezetten elküldheti, vagy használhatja a Header_GetImageList vagy Header_GetStateImageList makrót. |
HDM_GETITEM | Beolvashatja az élőfej vezérlőelem egyik eleméről szóló információkat. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_GetItem makrót. |
HDM_GETITEMCOUNT | Lekéri a fejlécvezérlő elemeinek számát. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_GetItemCount makrót. |
HDM_GETITEMDROPDOWNRECT | Lekéri a HDF_SPLITBUTTON stílussal rendelkező fejlécelem felosztás gombjának határoló téglalapját. Küldje el ezt az üzenetet explicit módon vagy aHeader_GetItemDropDownRectmakró használatával. |
HDM_GETITEMRECT | Lekéri egy adott elem határolókeretét egy fejlécvezérlőben. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_GetItemRect makrót. |
HDM_GETORDERARRAY | Lekéri a fejléc vezérlőelem elemeinek aktuális balról jobbra sorrendjét. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_GetOrderArray makrót. |
HDM_GETOVERFLOWRECT | Lekéri a túlcsordulás gomb határoló téglalapját, ha a HDS_OVERFLOW stílus be van állítva a fejléc vezérlőelemen, és a túlcsordulás gomb látható. Küldje el ezt az üzenetet explicit módon vagy aHeader_GetOverflowRectmakró használatával. |
HDM_GETUNICODEFORMAT | Lekéri a vezérlő Unicode-karakterformázási jelzőt. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_GetUnicodeFormat makrót. |
HDM_HITTEST | Tesztel egy pontot annak meghatározásához, hogy melyik fejlécelem (ha van ilyen) a megadott ponton. |
HDM_INSERTITEM | Új elemet szúr be egy fejlécvezérlőbe. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_InsertItem makrót. |
HDM_LAYOUT | Beolvassa a fejlécvezérlő méretének és pozíciójának a szülőablak cél téglalapon belüli beállításához használt adatokat. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_Layout makrót. |
HDM_ORDERTOINDEX | Lekéri egy elem indexértékét a fejléc vezérlőelemben lévő sorrendje alapján. Ezt az üzenetet kifejezetten elküldheti, vagy használhatja a Header_OrderToIndex makrót. |
HDM_SETBITMAPMARGIN | Beállítja egy meglévő fejlécvezérlő bitképének képpontban megadott margójának szélességét. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_SetBitmapMargin makrót. |
HDM_SETFILTERCHANGETIMEOUT | Beállítja az időtúllépési időközt a szűrőattribútumokban a módosítás időpontja és egy HDN_FILTERCHANGE értesítés közzététele között. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_SetFilterChangeTimeout makrót. |
HDM_SETFOCUSEDITEM | A fókuszt egy fejlécvezérlő megadott elemére állítja. Küldje el ezt az üzenetet explicit módon vagy a Header_SetFocusedItem makró használatával. |
HDM_SETHOTDIVIDER | A fejlécelemek közötti elválasztó színének módosítása külső húzási művelet céljának jelzésére. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_SetHotDivider makrót. |
HDM_SETIMAGELIST | Képlistát rendel egy meglévő fejlécvezérlőhöz. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_SetImageList vagy Header_SetStateImageList makrót. |
HDM_SETITEM | Beállítja a megadott elem attribútumait egy fejlécvezérlőben. Ezt az üzenetet kifejezetten elküldheti, vagy használhatja a Header_SetItem makrót. |
HDM_SETORDERARRAY | A fejlécelemek balról jobbra sorrendjét állítja be. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_SetOrderArray makrót. |
HDM_SETUNICODEFORMAT | Beállítja a unicode karakterformátum jelzőt a vezérlőelemhez. Ez az üzenet lehetővé teszi, hogy a vezérlő által használt karakterkészletet futásidőben módosítsa ahelyett, hogy újra létre kellene hoznia a vezérlőt. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Header_SetUnicodeFormat makrót. |
HDM_TRANSLATEACCELERATOR | Nincs implementálva. |
Értesítések
Téma | Tartalomjegyzék |
---|---|
HDN_BEGINDRAG | Egy fejlécvezérlő küldi el, ha egy húzási művelet elkezdődött az egyik elemén. Ezt az értesítési kódot csak a HDS_DRAGDROP stílusra beállított fejlécvezérlők küldik. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
HDN_BEGINFILTEREDIT | Értesíti a fejlécvezérlő szülőablakát, hogy megkezdődött a szűrőszerkesztés. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
HDN_BEGINTRACK | Értesíti a fejlécvezérlő szülőablakát, hogy a felhasználó megkezdte az elválasztó húzását a vezérlőben (vagyis a felhasználó lenyomta a bal egérgombot, miközben az egérmutató az élőfej-vezérlő egyik elválasztóján van). Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
HDN_DIVIDERDBLCLICK | Értesíti a fejlécvezérlő szülőablakát, hogy a felhasználó duplán kattintott a vezérlő elválasztó területére. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
HDN_DROPDOWN | Ha a fejlécvezérlő legördülő nyílra kattint, az élőfej vezérlőelem küldi el a szülőjének. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
HDN_ENDDRAG | Egy fejlécvezérlő küldi el, ha egy húzási művelet véget ért az egyik elemén. Ez az értesítési kód WM_NOTIFY üzenetként lesz elküldve. Ezt az értesítést csak a HDS_DRAGDROP stílusra beállított fejlécvezérlők küldik el. |
HDN_ENDFILTEREDIT | Értesíti a fejlécvezérlő szülőablakát, hogy a szűrőszerkesztés befejeződött. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
HDN_ENDTRACK | Értesíti a fejlécvezérlő szülőablakát, hogy a felhasználó befejezte az elválasztó húzását. Ez az értesítési kód WM_NOTIFY üzenet formájában küldve. |
HDN_FILTERBTNCLICK | Értesíti a fejlécvezérlő szülőablakát, amikor a szűrőgombra kattint, vagy egy HDM_SETITEM üzenetre válaszol. |
HDN_FILTERCHANGE | Értesíti a fejlécvezérlő szülőablakát, hogy a fejlécvezérlő-szűrő attribútumait módosítják vagy szerkesztik. |
HDN_GETDISPINFO | Elküldve a fejlécvezérlő tulajdonosának, ha a vezérlőnek információra van szüksége egy visszahívási fejlécelemről. Ez az értesítési kód WM_NOTIFY üzenetként lesz elküldve. |
HDN_ITEMCHANGED | Értesíti a fejlécvezérlő szülőablakát, hogy a fejlécelem attribútumai megváltoztak. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
HDN_ITEMCHANGING | Értesíti a fejlécvezérlő szülőablakát, hogy a fejlécelem attribútumai módosulni készülnek. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
HDN_ITEMCLICK | Értesíti a fejlécvezérlő szülőablakát, hogy a felhasználó a vezérlőre kattintott. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
HDN_ITEMDBLCLICK | Értesíti a fejlécvezérlő szülőablakát, hogy a felhasználó duplán kattintott a vezérlőre. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. Ezt az értesítést csak a HDS_BUTTONS stílusra beállított fejlécvezérlők küldik el. |
HDN_ITEMKEYDOWN | Értesíti a fejlécvezérlő szülőablakát, hogy egy kulcs ki van jelölve. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
HDN_ITEMSTATEICONCLICK | Értesíti a fejlécvezérlő szülőablakát, hogy a felhasználó egy elem állapotikonjára kattintott. |
HDN_OVERFLOWCLICK | Amikor a fejléc túlcsorduló gombjára kattint, egy fejlécvezérlő elküldi a szülőjének. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
HDN_TRACK | Értesíti a fejlécvezérlő szülőablakát, hogy a felhasználó elválasztót húz a fejlécvezérlőbe. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_CUSTOMDRAW (fejléc) | Egy fejlécvezérlő küldi el, hogy értesítse a szülőablakát a rajzműveletekről. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_RCLICK (fejléc) | Értesíti a fanézet vezérlőjének szülőablakát, hogy a felhasználó a vezérlőn belül a jobb egérgombra kattintott. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_RELEASEDCAPTURE (fejléc) | Értesíti a fejlécvezérlő szülőablakát, hogy a vezérlő egérrögzítést bocsát ki. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
Állandók
Téma | Tartalomjegyzék |
---|---|
Fejlécvezérlő stílusok | Az élőfej-vezérlők számos stílussal rendelkeznek, amelyeket ebben a szakaszban ismertetünk, amelyek meghatározzák a vezérlő megjelenését és működését. A fejlécvezérlő létrehozásakor meg kell adnia a kezdeti stílusokat. |