Eszköztár
Ez a szakasz az eszköztár-vezérlőkkel használt programozási elemekről tartalmaz információkat.
Áttekintés
Téma | Tartalomjegyzék |
---|---|
Eszköztárvezérlők | Az eszköztár egy vagy több gombot tartalmazó vezérlőelem. Amikor egy felhasználó rákattint, minden egyes gomb egy parancsüzenetet küld a szülőablakba. Az eszköztár gombjai általában az alkalmazás menüjében található elemeknek felelnek meg, így a felhasználó további és közvetlenebb módon férhet hozzá az alkalmazás parancsaihoz. |
Eszköztárvezérlők használata | Ez a témakör az alkalmazás eszköztár-vezérlőinek használatára vonatkozó implementáció részleteit és példakódját tartalmazza. |
Funkciók
Téma | Tartalomjegyzék |
---|---|
CreateMappedBitmap | Létrehoz egy bitképet az eszköztárban való használatra. |
CreateToolbarEx | Létrehoz egy eszköztárablakot, és hozzáadja a megadott gombokat az eszköztárhoz.
Megjegyzés: Ez a függvény elavult, mert nem támogatja az eszköztárak összes funkcióját. Ehelyett használja CreateWindowEx. Példák: Eszköztárvezérlők használata. |
Üzenetek
Téma | Tartalomjegyzék |
---|---|
TB_ADDBITMAP | Egy vagy több képet ad hozzá az eszköztárhoz elérhető gombképek listájához. |
TB_ADDBUTTONS | Egy vagy több gombot ad hozzá egy eszköztárhoz. |
TB_ADDSTRING | Új sztringet ad hozzá az eszköztár sztringkészletéhez. |
TB_AUTOSIZE | Az eszköztár átméretezését okozza. |
TB_BUTTONCOUNT | Lekéri az eszköztár aktuális gombjainak számát. |
TB_BUTTONSTRUCTSIZE | A TBBUTTON szerkezetének méretét adja meg. |
TB_CHANGEBITMAP | Módosítja egy gomb bitképét az eszköztáron. |
TB_CHECKBUTTON | Egy adott gombot ellenőriz vagy töröl egy eszköztáron. |
TB_COMMANDTOINDEX | Lekéri a megadott parancsazonosítóhoz társított gomb nullaalapú indexét. |
TB_CUSTOMIZE | Megjeleníti az Eszköztár testreszabása párbeszédpanelt. |
TB_DELETEBUTTON | Töröl egy gombot az eszköztárról. |
TB_ENABLEBUTTON | Engedélyezi vagy letiltja a megadott gombot egy eszköztáron. |
TB_GETANCHORHIGHLIGHT | Lekéri az eszköztár horgonykiemelési beállítását. |
TB_GETBITMAP | Lekéri az eszköztár egy gombjához társított bitkép indexét. |
TB_GETBITMAPFLAGS | Lekéri a használandó bitkép típusát leíró jelzőket. |
TB_GETBUTTON | Beolvassa az eszköztár megadott gombjára vonatkozó információkat. |
TB_GETBUTTONINFO | Az eszköztár egy gombjának kiterjesztett információit kéri le. |
TB_GETBUTTONSIZE | Az eszköztárgombok aktuális szélességét és magasságát kéri le képpontban. |
TB_GETBUTTONTEXT | Lekéri egy gomb megjelenítendő szövegét egy eszköztáron. |
TB_GETCOLORSCHEME | Lekéri a színséma adatait az eszköztár vezérlőelemből. |
TB_GETDISABLEDIMAGELIST | Lekéri azt a képlistát, amelyet egy eszköztár-vezérlő használ az inaktív gombok megjelenítéséhez. |
TB_GETEXTENDEDSTYLE | Lekéri az eszköztár vezérlőelem kiterjesztett stílusait. |
TB_GETHOTIMAGELIST | Lekéri azt a képlistát, amelyet egy eszköztár-vezérlő használ a gyakori elérésű gombok megjelenítéséhez. |
TB_GETHOTITEM | Lekéri a gyakori elemet tartalmazó indexet egy eszköztárban. |
TB_GETIDEALSIZE | Az eszköztár ideális méretét kapja meg. |
TB_GETIMAGELIST | Lekéri azt a képlistát, amellyel az eszköztár-vezérlők alapértelmezett állapotukban jelenítik meg a gombokat. Az eszköztár-vezérlők ezzel a képlistával jelenítik meg a gombokat, ha nem gyakori elérésűek vagy le vannak tiltva. |
TB_GETIMAGELISTCOUNT | Lekéri az eszköztárhoz társított képlisták számát. |
TB_GETINSERTMARK | Lekéri az eszköztár aktuális beszúrási jelét. |
TB_GETINSERTMARKCOLOR | Lekéri az eszköztár beszúrási jelének rajzolásához használt színt. |
TB_GETITEMDROPDOWNRECT | Lekéri egy eszköztárelem legördülő ablakának határoló téglalapját BTNS_DROPDOWNstílussal. |
TB_GETITEMRECT | Lekéri egy gomb határolókeretét egy eszköztárban. |
TB_GETMAXSIZE | Lekéri az eszköztár összes látható gombjának és elválasztó elemének teljes méretét. |
TB_GETMETRICS | Lekéri egy eszköztár vezérlőelem metrikáit. |
TB_GETOBJECT | Lekéri a IDropTarget egy eszköztár vezérlőelemhez. |
TB_GETPADDING | Lekéri egy eszköztár vezérlőelem kitöltését. |
TB_GETPRESSEDIMAGELIST | Lekéri azt a képlistát, amellyel az eszköztár-vezérlő lenyomott állapotban jeleníti meg a gombokat. |
TB_GETRECT | Lekéri egy adott eszköztárgomb határolókeretét. |
TB_GETROWS | Lekéri az eszköztár gombsorainak számát a TBSTYLE_WRAPABLE stílussal. |
TB_GETSTATE | Beolvassa az eszköztár megadott gombjának állapotával kapcsolatos információkat, például azt, hogy engedélyezve, lenyomva vagy bejelölve van-e. |
TB_GETSTRING | Sztringet kér le egy eszköztár sztringkészletéből. |
TB_GETSTYLE | Lekéri az eszköztár vezérlőelemhez jelenleg használt stílusokat. |
TB_GETTEXTROWS | Lekéri az eszköztárgombon megjeleníthető szövegsorok maximális számát. |
TB_GETTOOLTIPS | Lekéri a fogópontot az eszköztárhoz társított elemleírás-vezérlőhöz, ha van ilyen. |
TB_GETUNICODEFORMAT | Lekéri a vezérlő Unicode-karakterformátum-jelzőt. |
TB_HASACCELERATOR |
Belső használatra szánt; alkalmazáshoz nem ajánlott. Lekéri a megadott gyorsító karakterrel rendelkező eszköztárgombok számát. |
TB_HIDEBUTTON | Elrejti vagy megjeleníti a megadott gombot egy eszköztáron. |
TB_HITTEST | Meghatározza, hogy hol található egy pont egy eszköztár vezérlőelemben. |
TB_INDETERMINATE | Beállítja vagy törli a megadott gomb meghatározatlan állapotát egy eszköztáron. |
TB_INSERTBUTTON | Gomb beszúrása egy eszköztárba. |
TB_INSERTMARKHITTEST | Beolvassa az eszköztár egy pontjának beszúrási jeladatait. |
TB_ISBUTTONCHECKED | Meghatározza, hogy az eszköztár megadott gombja be van-e jelölve. |
TB_ISBUTTONENABLED | Meghatározza, hogy az eszköztár megadott gombja engedélyezve van-e. |
TB_ISBUTTONHIDDEN | Meghatározza, hogy az eszköztár megadott gombja rejtett-e. |
TB_ISBUTTONHIGHLIGHTED | Az eszköztár gomb kiemelési állapotát ellenőrzi. |
TB_ISBUTTONINDETERMINATE | Meghatározza, hogy az eszköztár megadott gombja meghatározatlan-e. |
TB_ISBUTTONPRESSED | Meghatározza, hogy az eszköztár megadott gombja be van-e nyomva. |
TB_LOADIMAGES | Betölti a rendszer által definiált gombképeket egy eszköztár-vezérlő képlistájába. |
TB_MAPACCELERATOR | Meghatározza a megadott gyorsító karakternek megfelelő gomb azonosítóját. |
TB_MARKBUTTON | Egy adott gomb kiemelési állapotát állítja be egy eszköztár vezérlőelemben. |
TB_MOVEBUTTON | Gomb áthelyezése egyik indexből a másikba. |
TB_PRESSBUTTON | Lenyomja vagy felengedi a megadott gombot egy eszköztáron. |
TB_REPLACEBITMAP | Meglévő bitkép lecserélése új bitképre. |
TB_SAVERESTORE | Ezt az üzenetet elküldve kezdeményezheti az eszköztár állapotának mentését vagy visszaállítását. |
TB_SETANCHORHIGHLIGHT | Beállítja az eszköztár horgonykiemelési beállítását. |
TB_SETBITMAPSIZE | Beállítja az eszköztárhoz hozzáadni kívánt bitképek méretét. |
TB_SETBOUNDINGSIZE |
Belső használatra szánt; alkalmazáshoz nem ajánlott. Többoszlopos eszköztár vezérlőelem határolóméretét állítja be. |
TB_SETBUTTONINFO | Egy meglévő gomb információinak beállítása egy eszköztáron. |
TB_SETBUTTONSIZE | Beállítja az eszköztár gombjainak méretét. |
TB_SETBUTTONWIDTH | Beállítja az eszköztár vezérlőelem minimális és maximális gombszélességeit. |
TB_SETCMDID | Beállítja egy eszköztárgomb parancsazonosítóját. |
TB_SETCOLORSCHEME | Beállítja az eszköztár vezérlőelem színsémaadatait. |
TB_SETDISABLEDIMAGELIST | Beállítja azt a képlistát, amelyet az eszköztár-vezérlő a letiltott gombok megjelenítésére fog használni. |
TB_SETDRAWTEXTFLAGS | Beállítja az eszköztár szöveges rajzjelölőit. |
TB_SETEXTENDEDSTYLE | Az eszköztár vezérlőelem kiterjesztett stílusainak beállítása. |
TB_SETHOTIMAGELIST | Beállítja azt a képlistát, amelyet az eszköztár-vezérlő használ a gyakori elérésű gombok megjelenítéséhez. |
TB_SETHOTITEM | A gyakori elemet egy eszköztáron állítja be. |
TB_SETHOTITEM2 | A gyakori elemet egy eszköztáron állítja be. |
TB_SETIMAGELIST | Beállítja az eszköztár által az alapértelmezett állapotban lévő gombok megjelenítéséhez használt képlistát. |
TB_SETINDENT | Az eszköztár vezérlőelem első gombjának behúzását állítja be. |
TB_SETINSERTMARK | Beállítja az eszköztár aktuális beszúrási jelét. |
TB_SETINSERTMARKCOLOR | Beállítja az eszköztár beszúrási jelének rajzolásához használt színt. |
TB_SETLISTGAP | Beállítja egy adott eszköztár eszköztárgombjai közötti távolságot. |
TB_SETMAXTEXTROWS | Az eszköztárgombon megjelenített szövegsorok maximális számát adja meg. |
TB_SETMETRICS | Egy eszköztár vezérlőelem metrikáit állítja be. |
TB_SETPADDING | Beállítja az eszköztár vezérlőelemek kitöltését. |
TB_SETPARENT | Beállítja azt az ablakot, amelyre az eszköztár-vezérlő értesítési kódokat küld. |
TB_SETPRESSEDIMAGELIST | Beállítja azt a képlistát, amelyet az eszköztár lenyomott állapotú gombok megjelenítésére használ. |
TB_SETROWS | Beállítja az eszköztár gombsorainak számát. |
TB_SETSTATE | Beállítja a megadott gomb állapotát egy eszköztáron. |
TB_SETSTYLE | Beállítja az eszköztár vezérlőelem stílusát. |
TB_SETTOOLTIPS | Elemleírás-vezérlő társítása eszköztárral. |
TB_SETUNICODEFORMAT | Beállítja a vezérlő Unicode karakterformátum-jelölőjének beállítását. 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. |
TB_SETWINDOWTHEME | Beállítja egy eszköztár vezérlőelem vizuális stílusát. |
TB_TRANSLATEACCELERATOR | Egy billentyűzetüzenetet ad át az eszköztárnak. |
Értesítések
Téma | Tartalomjegyzék |
---|---|
NM_CHAR (eszköztár) | Az eszköztár akkor küldi el, amikor WM_CHAR üzenetet kap. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_CLICK (eszköztár) | Egy eszköztár vezérlőelem küldi el, amikor a felhasználó a bal egérgombbal egy elemre kattint. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_CUSTOMDRAW (eszköztár) | Az eszköztár 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_DBLCLK (eszköztár) | Értesíti az eszköztár vezérlőelem szülőablakát, hogy a felhasználó duplán kattintott a vezérlő bal oldali gombjára. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_KEYDOWN (eszköztár) | Egy vezérlő küldi el, ha a vezérlő fókusza a billentyűzetre kerül, és a felhasználó lenyom egy billentyűt. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_LDOWN | Értesíti az eszköztár szülőablakát, hogy a bal egérgombot lenyomta. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_RCLICK (eszköztár) | Egy eszköztár vezérlőelem küldi el, amikor a felhasználó a jobb egérgombbal kattint az eszköztárra. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_RDBLCLK (eszköztár) | Értesíti a vezérlő szülőablakát, hogy a felhasználó duplán kattintott a jobb egérgombra a vezérlőn belül. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_RELEASEDCAPTURE (eszköztár) | Értesíti az eszköztár-vezérlő szülőablakát, hogy a vezérlő felengedi az egérrögzítést. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_TOOLTIPSCREATED (eszköztár) | Értesíti az eszköztár szülőablakát, hogy az eszköztár létrehozott egy elemleírás-vezérlőt. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_BEGINADJUST | Értesíti az eszköztár szülőablakát, hogy a felhasználó megkezdte az eszköztár testreszabását. Ezt az üzenetkódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_BEGINDRAG | Értesíti az eszköztár szülőablakát, hogy a felhasználó megkezdte egy gomb húzását az eszköztáron. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_CUSTHELP | Értesíti az eszköztár szülőablakát, hogy a felhasználó a Súgó gombot választotta az Eszköztár testreszabása párbeszédpanelen. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_DELETINGBUTTON | Egy eszköztár-vezérlő küldi el, ha egy gomb éppen törlésre készül. |
TBN_DRAGOUT | Egy eszköztár vezérlőelem küldi el, amikor a felhasználó rákattint egy gombra, majd a kurzort leküldi a gombra. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_DRAGOVER | Megállapítja, hogy TB_MARKBUTTON üzenetet kell-e küldeni az áthúzott gombhoz. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_DROPDOWN | Egy eszköztár vezérlőelem küldi el, amikor a felhasználó egy legördülő gombra kattint. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_DUPACCELERATOR | Megállapítja, hogy egy gyorsítókulcs használható-e két vagy több aktív eszköztáron. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_ENDADJUST | Értesíti az eszköztár szülőablakát, hogy a felhasználó leállította az eszköztár testreszabását. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_ENDDRAG | Értesíti az eszköztár szülőablakát, hogy a felhasználó leállította egy gomb húzását az eszköztáron. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_GETBUTTONINFO | Lekéri az eszköztár testreszabási adatait, és értesíti az eszköztár szülőablakát az eszköztáron végrehajtott módosításokról. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_GETDISPINFO | Lekéri az eszköztárelem megjelenítési adatait. Ezt az értesítést WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_GETINFOTIP | Beolvassa az eszköztárelem információs tippadatait. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_GETOBJECT | A TBSTYLE_REGISTERDROP stílust használó eszköztár-vezérlő küldi el a célobjektum lekéréséhez, amikor a mutató áthalad az egyik gombja felett. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_HOTITEMCHANGE | Egy eszköztár vezérlőelem küldi el, amikor a gyakori elérésű (kiemelt) elem megváltozik. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_INITCUSTOMIZE | Értesíti az eszköztár szülőablakát, amely megkezdődött a testreszabással. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_MAPACCELERATOR | Kéri a gomb indexét az eszköztárban, amely megfelel a megadott gyorsító karakternek. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_QUERYDELETE | Értesíti az eszköztár szülőablakát, hogy törölhető-e egy gomb egy eszköztárról, miközben a felhasználó testre szabja az eszköztárat. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_QUERYINSERT | Értesíti az eszköztár szülőablakát, hogy beszúrható-e egy gomb a megadott gombtól balra, miközben a felhasználó testre szab egy eszköztárat. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_RESET | Értesíti az eszköztár szülőablakát, hogy a felhasználó visszaállította az Eszköztár testreszabása párbeszédpanel tartalmát. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_RESTORE | Értesíti az eszköztár szülőablakát, hogy az eszköztár visszaállítása folyamatban van. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_SAVE | Értesíti az eszköztár szülőablakát, hogy az eszköztár mentése folyamatban van. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_TOOLBARCHANGE | Értesíti az eszköztár szülőablakát, hogy a felhasználó testre szabott egy eszköztárat. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_WRAPACCELERATOR | A gomb indexét kéri egy vagy több, a megadott gyorsító karakternek megfelelő eszköztáron. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
TBN_WRAPHOTITEM | Értesíti az alkalmazást két vagy több eszköztárral, hogy a gyakori elemet módosítani szeretné. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
Struktúrák
Téma | Tartalomjegyzék |
---|---|
COLORMAP | A CreateMappedBitmap függvény által a bitkép színeinek leképezéséhez használt információkat tartalmazza. |
NMTBCUSTOMDRAW | Az eszköztár vezérlőelem által küldött NM_CUSTOMDRAW értesítési kódra vonatkozó információkat tartalmazza. |
NMTBDISPINFO | Egy eszköztárelem megjelenítési adatait tartalmazza és fogadja. Ez a struktúra az TBN_GETDISPINFO értesítési kóddal használható. |
NMTBGETINFOTIP | Egy eszköztárelemhez tartozó információleírást tartalmaz és fogad. Ez a struktúra az TBN_GETINFOTIP értesítési kóddal használható. |
NMTBHOTITEM | A TBN_HOTITEMCHANGE értesítési kóddal használt információkat tartalmazza. |
NMTBRESTORE | Lehetővé teszi az alkalmazások számára, hogy kinyerjék az NMTBSAVE az eszköztár állapotának mentésekor elhelyezett információkat. Ezt a struktúrát a rendszer akkor továbbítja az alkalmazásoknak, amikor TBN_RESTORE értesítési kódot kapnak. |
NMTBSAVE | Ezt a struktúrát a rendszer akkor továbbítja az alkalmazásoknak, amikor TBN_SAVE értesítési kódot kapnak. Információkat tartalmaz a jelenleg mentett gombról. Az alkalmazások további információk mentéséhez módosíthatják a tagok értékeit. |
NMTOOLBAR | Az eszköztár értesítési kódjainak feldolgozásához használt információkat tartalmazza. Ez a struktúra felülírja a TBNOTIFY struktúrát. |
TBADDBITMAP | Gombképeket tartalmazó bitképet ad hozzá az eszköztárhoz. |
TBBUTTON | Az eszköztár gombjáról tartalmaz információkat. |
TBBUTTONINFO | Egy adott gomb adatait tartalmazza vagy fogadja az eszköztárban. |
TBINSERTMARK | Az eszköztár vezérlőelem beszúrási jelével kapcsolatos információkat tartalmaz. |
TBMETRICS | Meghatározza az eszköztár elemeinek zsugorítására vagy kibontására használt eszköztár metrikáit. |
TBREPLACEBITMAP | Az TB_REPLACEBITMAP üzenettel az egyik eszköztár bitképét lecseréli egy másikra. |
TBSAVEPARAMS | Megadja a beállításjegyzék azon helyét, ahol a TB_SAVERESTORE üzenet tárolja, és beolvassa az eszköztár állapotával kapcsolatos információkat. |
Állandók
Téma | Tartalomjegyzék |
---|---|
eszköztár gombállapotai | Ez a szakasz az eszköztárgombok állapotait sorolja fel. |
Eszköztár vezérlőelem és gombstílusok | Az alábbi ablakstílusok az eszköztárakra vonatkoznak. Az eszköztár létrehozásakor a rendszer más ablakstílusokkal kombinálja őket. Megjegyzés: A Közös vezérlőkhöz 6.00-verzió esetén, ha vizuális stílus t használ az eszköztárral, a gombok a stílusbeállítástól függetlenül mindig átlátszóak. Ellenkező esetben a TBSTYLE_FLAT vagy TBSTYLE_TRANSPARENT stílus használata által jelzett átlátszóság normális. Megjegyzés: Comctl32.dll 6-os verzió nem terjeszthető újra, de windowsos vagy újabb verzióban is elérhető. A Comctl32.dll 6-os verziójának használatához adja meg egy jegyzékben. További információ a jegyzékekről: Vizuális stílusok engedélyezése. |
eszköztár bővített stílusai | Ez a szakasz az eszköztár-vezérlők által támogatott kiterjesztett stílusokat sorolja fel. |
eszköztár standard gomb képindexének értékei | Ez a szakasz a normál bitképeken belüli képek indexértékeit adja meg. |