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.