Panel nástrojů
Tato část obsahuje informace o programovacích prvcích používaných s ovládacími prvky panelu nástrojů.
Přehledy
| Námět | Obsah |
|---|---|
| o ovládacích prvcích panelu nástrojů | Panel nástrojů je ovládací prvek, který obsahuje jedno nebo více tlačítek. Každé tlačítko po kliknutí uživatelem odešle zprávu příkazu do nadřazeného okna. Tlačítka na panelu nástrojů obvykle odpovídají položkám v nabídce aplikace a poskytují uživateli další a přímější způsob přístupu k příkazům aplikace. |
| použití ovládacích prvků panelu nástrojů | Toto téma obsahuje podrobnosti implementace a ukázkový kód pro použití ovládacích prvků panelu nástrojů v aplikacích. |
Funkce
| Námět | Obsah |
|---|---|
| createMappedBitmap | Vytvoří rastrový obrázek pro použití na panelu nástrojů. |
| CreateToolbarEx | Vytvoří okno panelu nástrojů a přidá zadaná tlačítka na panel nástrojů.
Poznámka: Tato funkce je zastaralá, protože nepodporuje všechny funkce panelů nástrojů. Místo toho použijte CreateWindowEx. Příklady najdete v tématu Použití ovládacích prvků panelu nástrojů. |
Zprávy
| Námět | Obsah |
|---|---|
| TB_ADDBITMAP | Přidá jeden nebo více obrázků do seznamu obrázků tlačítek, které jsou k dispozici pro panel nástrojů. |
| TB_ADDBUTTONS | Přidá jedno nebo více tlačítek na panel nástrojů. |
| TB_ADDSTRING | Přidá nový řetězec do fondu řetězců panelu nástrojů. |
| TB_AUTOSIZE | Způsobí změnu velikosti panelu nástrojů. |
| TB_BUTTONCOUNT | Načte počet tlačítek aktuálně na panelu nástrojů. |
| TB_BUTTONSTRUCTSIZE | Určuje velikost struktury TBBUTTON. |
| TB_CHANGEBITMAP | Změní rastrový obrázek tlačítka na panelu nástrojů. |
| TB_CHECKBUTTON | Kontroluje nebo zruší zaškrtnutí daného tlačítka na panelu nástrojů. |
| TB_COMMANDTOINDEX | Načte index založený na nule pro tlačítko přidružené k zadanému identifikátoru příkazu. |
| TB_CUSTOMIZE | Zobrazí dialogové okno Přizpůsobit panel nástrojů. |
| TB_DELETEBUTTON | Odstraní tlačítko z panelu nástrojů. |
| TB_ENABLEBUTTON | Povolí nebo zakáže zadané tlačítko na panelu nástrojů. |
| TB_GETANCHORHIGHLIGHT | Načte nastavení zvýraznění ukotvení panelu nástrojů. |
| TB_GETBITMAP | Načte index rastrového obrázku přidruženého k tlačítku na panelu nástrojů. |
| TB_GETBITMAPFLAGS | Načte příznaky, které popisují typ rastrového obrázku, který se má použít. |
| TB_GETBUTTON | Načte informace o zadaném tlačítku na panelu nástrojů. |
| TB_GETBUTTONINFO | Načte rozšířené informace pro tlačítko na panelu nástrojů. |
| TB_GETBUTTONSIZE | Načte aktuální šířku a výšku tlačítek panelu nástrojů v pixelech. |
| TB_GETBUTTONTEXT | Načte zobrazovaný text tlačítka na panelu nástrojů. |
| TB_GETCOLORSCHEME | Načte informace o barevném schématu z ovládacího prvku panelu nástrojů. |
| TB_GETDISABLEDIMAGELIST | Načte seznam obrázků, který ovládací prvek panelu nástrojů používá k zobrazení neaktivních tlačítek. |
| TB_GETEXTENDEDSTYLE | Načte rozšířené styly ovládacího prvku panelu nástrojů. |
| TB_GETHOTIMAGELIST | Načte seznam obrázků, který ovládací prvek panelu nástrojů používá k zobrazení horkých tlačítek. |
| TB_GETHOTITEM | Načte index horké položky na panelu nástrojů. |
| TB_GETIDEALSIZE | Získá ideální velikost panelu nástrojů. |
| TB_GETIMAGELIST | Načte seznam obrázků, který ovládací prvek panelu nástrojů používá k zobrazení tlačítek ve výchozím stavu. Ovládací prvek panelu nástrojů používá tento seznam obrázků k zobrazení tlačítek, pokud nejsou horké nebo zakázané. |
| TB_GETIMAGELISTCOUNT | Získá počet seznamů obrázků přidružených k panelu nástrojů. |
| TB_GETINSERTMARK | Načte aktuální značku vložení panelu nástrojů. |
| TB_GETINSERTMARKCOLOR | Načte barvu použitou k vykreslení značky vložení panelu nástrojů. |
| TB_GETITEMDROPDOWNRECT | Získá ohraničující obdélník okna rozevíracího seznamu pro položku panelu nástrojů se stylem BTNS_DROPDOWN. |
| TB_GETITEMRECT | Načte ohraničující obdélník tlačítka na panelu nástrojů. |
| TB_GETMAXSIZE | Načte celkovou velikost všech viditelných tlačítek a oddělovačů na panelu nástrojů. |
| TB_GETMETRICS | Načte metriky ovládacího prvku panelu nástrojů. |
| TB_GETOBJECT | Načte IDropTarget pro ovládací prvek panelu nástrojů. |
| TB_GETPADDING | Načte odsazení ovládacího prvku panelu nástrojů. |
| TB_GETPRESSEDIMAGELIST | Získá seznam obrázků, který ovládací prvek panelu nástrojů používá k zobrazení tlačítek ve stisknutém stavu. |
| TB_GETRECT | Načte ohraničující obdélník pro zadané tlačítko panelu nástrojů. |
| TB_GETROWS | Načte počet řádků tlačítek na panelu nástrojů pomocí stylu TBSTYLE_WRAPABLE. |
| TB_GETSTATE | Načte informace o stavu zadaného tlačítka na panelu nástrojů, například zda je povoleno, stisknuto nebo zaškrtnuto. |
| TB_GETSTRING | Načte řetězec z fondu řetězců panelu nástrojů. |
| TB_GETSTYLE | Načte aktuálně používané styly pro ovládací prvek panelu nástrojů. |
| TB_GETTEXTROWS | Načte maximální počet textových řádků, které lze zobrazit na tlačítku panelu nástrojů. |
| TB_GETTOOLTIPS | Načte popisovač do ovládacího prvku popisku( pokud existuje) přidružený k panelu nástrojů. |
| TB_GETUNICODEFORMAT | Načte příznak formátu znaku Unicode pro ovládací prvek. |
| TB_HASACCELERATOR |
Určený pro interní použití; nedoporučuje se používat v aplikacích. Načte počet tlačítek panelu nástrojů se zadaným znakem akcelerátoru. |
| TB_HIDEBUTTON | Skryje nebo zobrazí zadané tlačítko na panelu nástrojů. |
| TB_HITTEST | Určuje, kde bod leží v ovládacím prvku panelu nástrojů. |
| TB_INDETERMINATE | Nastaví nebo vymaže neurčitý stav zadaného tlačítka na panelu nástrojů. |
| TB_INSERTBUTTON | Vloží tlačítko na panel nástrojů. |
| TB_INSERTMARKHITTEST | Načte informace o značce vložení pro bod na panelu nástrojů. |
| TB_ISBUTTONCHECKED | Určuje, zda je zadané tlačítko na panelu nástrojů zaškrtnuté. |
| TB_ISBUTTONENABLED | Určuje, zda je zadané tlačítko na panelu nástrojů povoleno. |
| TB_ISBUTTONHIDDEN | Určuje, zda je zadané tlačítko na panelu nástrojů skryté. |
| TB_ISBUTTONHIGHLIGHTED | Zkontroluje stav zvýraznění tlačítka panelu nástrojů. |
| TB_ISBUTTONINDETERMINATE | Určuje, zda je zadané tlačítko na panelu nástrojů neurčité. |
| TB_ISBUTTONPRESSED | Určuje, zda je zadané tlačítko na panelu nástrojů stisknuto. |
| TB_LOADIMAGES | Načte obrázky tlačítek definované systémem do seznamu obrázků ovládacího prvku panelu nástrojů. |
| TB_MAPACCELERATOR | Určuje ID tlačítka, které odpovídá zadanému znaku akcelerátoru. |
| TB_MARKBUTTON | Nastaví stav zvýraznění daného tlačítka v ovládacím prvku panelu nástrojů. |
| TB_MOVEBUTTON | Přesune tlačítko z jednoho indexu do druhého. |
| TB_PRESSBUTTON | Stiskne nebo uvolní zadané tlačítko na panelu nástrojů. |
| TB_REPLACEBITMAP | Nahradí existující rastrový obrázek novým rastrovým obrázkem. |
| TB_SAVERESTORE | Odešlete tuto zprávu, která zahájí ukládání nebo obnovení stavu panelu nástrojů. |
| TB_SETANCHORHIGHLIGHT | Nastaví nastavení zvýraznění ukotvení panelu nástrojů. |
| TB_SETBITMAPSIZE | Nastaví velikost rastrových obrázků, které se mají přidat na panel nástrojů. |
| TB_SETBOUNDINGSIZE |
Určený pro interní použití; nedoporučuje se používat v aplikacích. Nastaví ohraničující velikost ovládacího prvku panelu nástrojů s více sloupci. |
| TB_SETBUTTONINFO | Nastaví informace pro existující tlačítko na panelu nástrojů. |
| TB_SETBUTTONSIZE | Nastaví velikost tlačítek na panelu nástrojů. |
| TB_SETBUTTONWIDTH | Nastaví minimální a maximální šířku tlačítka v ovládacím prvku panelu nástrojů. |
| TB_SETCMDID | Nastaví identifikátor příkazu tlačítka panelu nástrojů. |
| TB_SETCOLORSCHEME | Nastaví informace o barevném schématu pro ovládací prvek panelu nástrojů. |
| TB_SETDISABLEDIMAGELIST | Nastaví seznam obrázků, který bude ovládací prvek panelu nástrojů používat k zobrazení zakázaných tlačítek. |
| TB_SETDRAWTEXTFLAGS | Nastaví příznaky kreslení textu pro panel nástrojů. |
| TB_SETEXTENDEDSTYLE | Nastaví rozšířené styly pro ovládací prvek panelu nástrojů. |
| TB_SETHOTIMAGELIST | Nastaví seznam obrázků, který bude ovládací prvek panelu nástrojů používat k zobrazení horkých tlačítek. |
| TB_SETHOTITEM | Nastaví horkou položku na panelu nástrojů. |
| TB_SETHOTITEM2 | Nastaví horkou položku na panelu nástrojů. |
| TB_SETIMAGELIST | Nastaví seznam obrázků, který panel nástrojů používá k zobrazení tlačítek ve výchozím stavu. |
| TB_SETINDENT | Nastaví odsazení prvního tlačítka v ovládacím prvku panelu nástrojů. |
| TB_SETINSERTMARK | Nastaví aktuální značku vložení panelu nástrojů. |
| TB_SETINSERTMARKCOLOR | Nastaví barvu použitou k vykreslení značky vložení panelu nástrojů. |
| TB_SETLISTGAP | Nastaví vzdálenost mezi tlačítky panelu nástrojů na konkrétním panelu nástrojů. |
| TB_SETMAXTEXTROWS | Nastaví maximální počet textových řádků zobrazených na tlačítku panelu nástrojů. |
| TB_SETMETRICS | Nastaví metriky ovládacího prvku panelu nástrojů. |
| TB_SETPADDING | Nastaví odsazení ovládacího prvku panelu nástrojů. |
| TB_SETPARENT | Nastaví okno, na které ovládací prvek panelu nástrojů odesílá kódy oznámení. |
| TB_SETPRESSEDIMAGELIST | Nastaví seznam obrázků, který panel nástrojů používá k zobrazení tlačítek, která jsou ve stisknutém stavu. |
| TB_SETROWS | Nastaví počet řádků tlačítek na panelu nástrojů. |
| TB_SETSTATE | Nastaví stav zadaného tlačítka na panelu nástrojů. |
| TB_SETSTYLE | Nastaví styl ovládacího prvku panelu nástrojů. |
| TB_SETTOOLTIPS | Přidruží ovládací prvek popisku k panelu nástrojů. |
| TB_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. |
| TB_SETWINDOWTHEME | Nastaví vizuální styl ovládacího prvku panelu nástrojů. |
| TB_TRANSLATEACCELERATOR | Předá na panel nástrojů zprávu klávesnice. |
Upozornění
| Námět | Obsah |
|---|---|
| NM_CHAR (panel nástrojů) | Odesláno panelem nástrojů, když obdrží WM_CHAR zprávu. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_CLICK (panel nástrojů) | Když uživatel klikne na položku levým tlačítkem myši, odešle ho ovládací prvek panelu nástrojů. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_CUSTOMDRAW (panel nástrojů) | Odesláno panelem nástrojů, aby informovalo nadřazené okno o operacích kreslení. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_DBLCLK (panel nástrojů) | Upozorní nadřazené okno ovládacího prvku panelu nástrojů, že uživatel dvakrát kliknul na levé tlačítko myši v ovládacím prvku. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_KEYDOWN (panel nástrojů) | Odešle ovládací prvek, když má ovládací prvek fokus klávesnice a uživatel stiskne klávesu. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_LDOWN | Upozorní nadřazené okno panelu nástrojů, že bylo stisknuto levé tlačítko myši. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_RCLICK (panel nástrojů) | Když uživatel klikne na panel nástrojů pravým tlačítkem myši, odešle ho ovládací prvek panelu nástrojů. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_RDBLCLK (panel nástrojů) | Upozorní nadřazené okno ovládacího prvku, že uživatel dvakrát kliknul na pravé tlačítko myši v ovládacím prvku. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_RELEASEDCAPTURE (panel nástrojů) | Upozorní nadřazené okno ovládacího prvku panelu nástrojů, že ovládací prvek uvolní zachycení myši. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_TOOLTIPSCREATED (panel nástrojů) | Upozorní nadřazené okno panelu nástrojů, že panel nástrojů vytvořil ovládací prvek popisku. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_BEGINADJUST | Upozorní nadřazené okno panelu nástrojů, že uživatel začal přizpůsobovat panel nástrojů. Tento kód zprávy se odešle ve formě WM_NOTIFY zprávy. |
| TBN_BEGINDRAG | Upozorní nadřazené okno panelu nástrojů, že uživatel začal přetahovat tlačítko na panelu nástrojů. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_CUSTHELP | Upozorní nadřazené okno panelu nástrojů, že uživatel vybral tlačítko Nápověda v dialogovém okně Přizpůsobit panel nástrojů. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_DELETINGBUTTON | Odešle ovládací prvek panelu nástrojů, když se chystá tlačítko odstranit. |
| TBN_DRAGOUT | Když uživatel klikne na tlačítko a přesune kurzor mimo tlačítko, odešle ho ovládací prvek panelu nástrojů. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_DRAGOVER | Zjistí, zda má být odeslána TB_MARKBUTTON zpráva pro tlačítko, které je přetaženo. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_DROPDOWN | Když uživatel klikne na tlačítko rozevíracího seznamu, odešle ho ovládací prvek panelu nástrojů. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_DUPACCELERATOR | Zjistí, jestli lze klávesu akcelerátoru použít na dvou nebo více aktivních panelech nástrojů. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_ENDADJUST | Upozorní nadřazené okno panelu nástrojů, že uživatel přestal přizpůsobovat panel nástrojů. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_ENDDRAG | Upozorní nadřazené okno panelu nástrojů, že uživatel přestal přetahovat tlačítko na panelu nástrojů. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_GETBUTTONINFO | Načte informace o přizpůsobení panelu nástrojů a upozorní nadřazené okno panelu nástrojů o všech změnách provedených na panelu nástrojů. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_GETDISPINFO | Načte informace o zobrazení položky panelu nástrojů. Toto oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_GETINFOTIP | Načte informace o informačním tipu pro položku panelu nástrojů. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_GETOBJECT | Odesláno ovládacím prvku panelu nástrojů, který používá styl TBSTYLE_REGISTERDROP k vyžádání cílového objektu přetažení, když ukazatel přejde přes jedno z jeho tlačítek. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_HOTITEMCHANGE | Odeslání ovládacím prvku panelu nástrojů při změně horké (zvýrazněné) položky Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_INITCUSTOMIZE | Upozorní nadřazené okno panelu nástrojů, že se spustilo přizpůsobení. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_MAPACCELERATOR | Vyžádá index tlačítka na panelu nástrojů odpovídající zadanému znaku akcelerátoru. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_QUERYDELETE | Upozorní nadřazené okno panelu nástrojů, zda může být tlačítko odstraněno z panelu nástrojů, zatímco uživatel upravuje panel nástrojů. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_QUERYINSERT | Upozorní nadřazené okno panelu nástrojů, jestli se tlačítko může vložit doleva od zadaného tlačítka, zatímco uživatel upravuje panel nástrojů. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_RESET | Upozorní nadřazené okno panelu nástrojů, že uživatel resetoval obsah dialogového okna Přizpůsobit panel nástrojů. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_RESTORE | Upozorní nadřazené okno panelu nástrojů, že se panel nástrojů právě obnovuje. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_SAVE | Upozorní nadřazené okno panelu nástrojů, že se panel nástrojů právě ukládá. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_TOOLBARCHANGE | Upozorní nadřazené okno panelu nástrojů, že uživatel přizpůsobil panel nástrojů. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_WRAPACCELERATOR | Požaduje index tlačítka na jednom nebo více panelech nástrojů odpovídajících zadanému znaku akcelerátoru. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| TBN_WRAPHOTITEM | Upozorní aplikaci se dvěma nebo více panely nástrojů, že se aktivní položka chystá změnit. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
Struktury
| Námět | Obsah |
|---|---|
| COLORMAP | Obsahuje informace používané funkcí CreateMappedBitmap k mapování barev rastrového obrázku. |
| NMTBCUSTOMDRAW | Obsahuje informace specifické pro kód oznámení NM_CUSTOMDRAW odeslaný ovládacím panelem nástrojů. |
| NMTBDISPINFO | Obsahuje a přijímá informace o zobrazení položky panelu nástrojů. Tato struktura se používá s kódem oznámení TBN_GETDISPINFO. |
| NMTBGETINFOTIP | Obsahuje a přijímá informace o informačním tipu pro položku panelu nástrojů. Tato struktura se používá s kódem oznámení TBN_GETINFOTIP. |
| NMTBHOTITEM | Obsahuje informace používané s kódem oznámení TBN_HOTITEMCHANGE. |
| NMTBRESTORE | Umožňuje aplikacím extrahovat informace, které byly umístěny v NMTBSAVE při uložení stavu panelu nástrojů. Tato struktura se předá aplikacím, když obdrží kód oznámení TBN_RESTORE. |
| NMTBSAVE | Tato struktura se předá aplikacím, když obdrží kód oznámení TBN_SAVE. Obsahuje informace o aktuálně uloženém tlačítku. Aplikace mohou upravovat hodnoty členů, aby uložily další informace. |
| NMTOOLBAR | Obsahuje informace používané ke zpracování kódů oznámení panelu nástrojů. Tato struktura nahrazuje strukturu TBNOTIFY. |
| TBADDBITMAP | Přidá rastrový obrázek, který obsahuje obrázky tlačítek na panel nástrojů. |
| TBBUTTON | Obsahuje informace o tlačítku na panelu nástrojů. |
| TBBUTTONINFO | Obsahuje nebo přijímá informace o konkrétním tlačítku na panelu nástrojů. |
| TBINSERTMARK | Obsahuje informace o značce vložení v ovládacím prvku panelu nástrojů. |
| TBMETRICS | Definuje metriky panelu nástrojů, které slouží ke zmenšení nebo rozbalení položek panelu nástrojů. |
| TBREPLACEBITMAP | Používá se se zprávou TB_REPLACEBITMAP nahradit jeden rastrový obrázek panelu nástrojů jiným. |
| TBSAVEPARAMS | Určuje umístění v registru, kde TB_SAVERESTORE zpráva ukládá a načítá informace o stavu panelu nástrojů. |
Konstanty
| Námět | Obsah |
|---|---|
| Stavy tlačítek panelu nástrojů | V této části jsou uvedeny stavy, které může tlačítko panelu nástrojů obsahovat. |
| Ovládací prvek panelu nástrojů a styly tlačítek | Následující styly oken jsou specifické pro panely nástrojů. Při vytváření panelu nástrojů se kombinují s jinými styly oken. Poznámka Pro běžné ovládací prvky verze 6.00, pokud vizuální styl se používá s panelem nástrojů, tlačítka jsou vždy průhledná bez ohledu na nastavení stylu. V opačném případě je chování průhlednosti normální, jak je uvedeno použitím TBSTYLE_FLAT nebo stylu TBSTYLE_TRANSPARENT. Poznámka: Comctl32.dll verze 6 není distribuovatelná, ale je součástí Windows nebo novější. Pokud chcete použít Comctl32.dll verze 6, zadejte ho v manifestu. Další informace o manifestech najdete v tématu Povolení vizuálních stylů. |
| Toolbar Extended Styles | V této části jsou uvedeny rozšířené styly podporované ovládacími prvky panelu nástrojů. |
| hodnoty indexu obrázku standardního tlačítka panelu nástrojů | Tato část určuje hodnoty indexu obrázků v rámci standardních rastrových obrázků. |