Verktygsfält
Det här avsnittet innehåller information om de programmeringselement som används med verktygsfältskontroller.
Översikter
Ämne | Innehåll |
---|---|
Om verktygsfältskontroller | Ett verktygsfält är en kontroll som innehåller en eller flera knappar. Varje knapp, när den klickas av en användare, skickar ett kommandomeddelande till det överordnade fönstret. Vanligtvis motsvarar knapparna i ett verktygsfält objekt i programmets meny, vilket ger ett ytterligare och mer direkt sätt för användaren att komma åt ett programs kommandon. |
med hjälp av verktygsfältskontroller | Det här avsnittet innehåller implementeringsinformation och exempelkod för att använda verktygsfältskontroller i dina program. |
Funktioner
Ämne | Innehåll |
---|---|
CreateMappedBitmap | Skapar en bitmapp för användning i ett verktygsfält. |
CreateToolbarEx | Skapar ett verktygsfältsfönster och lägger till de angivna knapparna i verktygsfältet.
Obs! Den här funktionen är inaktuell eftersom den inte stöder alla funktioner i verktygsfält. Använd CreateWindowEx i stället. Exempel finns i Använda verktygsfältskontroller. |
Meddelanden
Ämne | Innehåll |
---|---|
TB_ADDBITMAP | Lägger till en eller flera bilder i listan över knappbilder som är tillgängliga för ett verktygsfält. |
TB_ADDBUTTONS | Lägger till en eller flera knappar i ett verktygsfält. |
TB_ADDSTRING | Lägger till en ny sträng i verktygsfältets strängpool. |
TB_AUTOSIZE | Gör att ett verktygsfält ändras. |
TB_BUTTONCOUNT | Hämtar ett antal knappar som för närvarande finns i verktygsfältet. |
TB_BUTTONSTRUCTSIZE | Anger storleken på TBBUTTON- struktur. |
TB_CHANGEBITMAP | Ändrar bitmappen för en knapp i ett verktygsfält. |
TB_CHECKBUTTON | Kontrollerar eller avmarkerar en viss knapp i ett verktygsfält. |
TB_COMMANDTOINDEX | Hämtar det nollbaserade indexet för knappen som är associerad med den angivna kommandoidentifieraren. |
TB_CUSTOMIZE | Visar dialogrutan Anpassa verktygsfält. |
TB_DELETEBUTTON | Tar bort en knapp från verktygsfältet. |
TB_ENABLEBUTTON | Aktiverar eller inaktiverar den angivna knappen i ett verktygsfält. |
TB_GETANCHORHIGHLIGHT | Hämtar fästpunktsinställningen för ett verktygsfält. |
TB_GETBITMAP | Hämtar indexet för bitmappen som är associerad med en knapp i ett verktygsfält. |
TB_GETBITMAPFLAGS | Hämtar flaggorna som beskriver vilken typ av bitmapp som ska användas. |
TB_GETBUTTON | Hämtar information om den angivna knappen i ett verktygsfält. |
TB_GETBUTTONINFO | Hämtar utökad information för en knapp i ett verktygsfält. |
TB_GETBUTTONSIZE | Hämtar den aktuella bredden och höjden på verktygsfältsknapparna i bildpunkter. |
TB_GETBUTTONTEXT | Hämtar visningstexten för en knapp i ett verktygsfält. |
TB_GETCOLORSCHEME | Hämtar färgschemainformationen från verktygsfältskontrollen. |
TB_GETDISABLEDIMAGELIST | Hämtar den bildlista som en verktygsfältskontroll använder för att visa inaktiva knappar. |
TB_GETEXTENDEDSTYLE | Hämtar utökade formatmallar för en verktygsfältskontroll. |
TB_GETHOTIMAGELIST | Hämtar den bildlista som en verktygsfältskontroll använder för att visa snabbknappar. |
TB_GETHOTITEM | Hämtar indexet för det heta objektet i ett verktygsfält. |
TB_GETIDEALSIZE | Hämtar den ideala storleken på verktygsfältet. |
TB_GETIMAGELIST | Hämtar den bildlista som en verktygsfältskontroll använder för att visa knappar i deras standardtillstånd. En verktygsfältskontroll använder den här bildlistan för att visa knappar när de inte är aktiva eller inaktiverade. |
TB_GETIMAGELISTCOUNT | Hämtar antalet bildlistor som är associerade med verktygsfältet. |
TB_GETINSERTMARK | Hämtar den aktuella insättningsmarkeringen för verktygsfältet. |
TB_GETINSERTMARKCOLOR | Hämtar den färg som används för att rita insättningsmarkeringen för verktygsfältet. |
TB_GETITEMDROPDOWNRECT | Hämtar avgränsningsrektangeln i listrutan för ett verktygsfältsobjekt med formatmallen BTNS_DROPDOWN. |
TB_GETITEMRECT | Hämtar avgränsningsrektangeln för en knapp i ett verktygsfält. |
TB_GETMAXSIZE | Hämtar den totala storleken på alla synliga knappar och avgränsare i verktygsfältet. |
TB_GETMETRICS | Hämtar måtten för en verktygsfältskontroll. |
TB_GETOBJECT | Hämtar IDropTarget- för en verktygsfältskontroll. |
TB_GETPADDING | Hämtar utfyllnad för en verktygsfältskontroll. |
TB_GETPRESSEDIMAGELIST | Hämtar den bildlista som en verktygsfältskontroll använder för att visa knappar i ett pressat tillstånd. |
TB_GETRECT | Hämtar avgränsningsrektangeln för en angiven verktygsfältsknapp. |
TB_GETROWS | Hämtar antalet rader med knappar i ett verktygsfält med TBSTYLE_WRAPABLE formatmall. |
TB_GETSTATE | Hämtar information om tillståndet för den angivna knappen i ett verktygsfält, till exempel om den är aktiverad, tryckt eller markerad. |
TB_GETSTRING | Hämtar en sträng från ett verktygsfälts strängpool. |
TB_GETSTYLE | Hämtar de formatmallar som används för en verktygsfältskontroll. |
TB_GETTEXTROWS | Hämtar det maximala antalet textrader som kan visas på en knapp i verktygsfältet. |
TB_GETTOOLTIPS | Hämtar handtaget till knappbeskrivningskontrollen, om någon, som är associerad med verktygsfältet. |
TB_GETUNICODEFORMAT | Hämtar unicode-teckenformatflaggan för kontrollen. |
TB_HASACCELERATOR |
Avsedd för internt bruk. rekommenderas inte för användning i program. Hämtar ett antal verktygsfältsknappar som har det angivna acceleratortecknet. |
TB_HIDEBUTTON | Döljer eller visar den angivna knappen i ett verktygsfält. |
TB_HITTEST | Avgör var en punkt ligger i en verktygsfältskontroll. |
TB_INDETERMINATE | Anger eller rensar det obestämda tillståndet för den angivna knappen i ett verktygsfält. |
TB_INSERTBUTTON | Infogar en knapp i ett verktygsfält. |
TB_INSERTMARKHITTEST | Hämtar infogningsmarkeringsinformationen för en punkt i ett verktygsfält. |
TB_ISBUTTONCHECKED | Avgör om den angivna knappen i ett verktygsfält är markerad. |
TB_ISBUTTONENABLED | Avgör om den angivna knappen i ett verktygsfält är aktiverad. |
TB_ISBUTTONHIDDEN | Avgör om den angivna knappen i ett verktygsfält är dold. |
TB_ISBUTTONHIGHLIGHTED | Kontrollerar markeringstillståndet för en knapp i verktygsfältet. |
TB_ISBUTTONINDETERMINATE | Avgör om den angivna knappen i ett verktygsfält är obestämd. |
TB_ISBUTTONPRESSED | Avgör om den angivna knappen i ett verktygsfält trycks in. |
TB_LOADIMAGES | Läser in systemdefinierade knappbilder i en verktygsfältskontrolls bildlista. |
TB_MAPACCELERATOR | Avgör ID för knappen som motsvarar det angivna acceleratortecknet. |
TB_MARKBUTTON | Anger markeringstillståndet för en viss knapp i en verktygsfältskontroll. |
TB_MOVEBUTTON | Flyttar en knapp från ett index till ett annat. |
TB_PRESSBUTTON | Trycker på eller släpper den angivna knappen i ett verktygsfält. |
TB_REPLACEBITMAP | Ersätter en befintlig bitmapp med en ny bitmapp. |
TB_SAVERESTORE | Skicka det här meddelandet för att initiera besparing eller återställning av ett verktygsfältstillstånd. |
TB_SETANCHORHIGHLIGHT | Anger fästpunktsinställningen för ett verktygsfält. |
TB_SETBITMAPSIZE | Anger storleken på de bitmappade bilder som ska läggas till i ett verktygsfält. |
TB_SETBOUNDINGSIZE |
Avsedd för internt bruk. rekommenderas inte för användning i program. Anger avgränsningsstorleken för en verktygsfältskontroll med flera kolumner. |
TB_SETBUTTONINFO | Anger informationen för en befintlig knapp i ett verktygsfält. |
TB_SETBUTTONSIZE | Anger storleken på knapparna i ett verktygsfält. |
TB_SETBUTTONWIDTH | Anger minsta och högsta knappbredder i verktygsfältskontrollen. |
TB_SETCMDID | Anger kommandoidentifieraren för en verktygsfältsknapp. |
TB_SETCOLORSCHEME | Anger färgschemainformationen för verktygsfältskontrollen. |
TB_SETDISABLEDIMAGELIST | Anger den bildlista som verktygsfältskontrollen ska använda för att visa inaktiverade knappar. |
TB_SETDRAWTEXTFLAGS | Anger textritningsflaggor för verktygsfältet. |
TB_SETEXTENDEDSTYLE | Anger utökade format för en verktygsfältskontroll. |
TB_SETHOTIMAGELIST | Anger den bildlista som verktygsfältskontrollen ska använda för att visa snabbknappar. |
TB_SETHOTITEM | Anger det heta objektet i ett verktygsfält. |
TB_SETHOTITEM2 | Anger det heta objektet i ett verktygsfält. |
TB_SETIMAGELIST | Anger den bildlista som verktygsfältet använder för att visa knappar som är i standardtillstånd. |
TB_SETINDENT | Anger indraget för den första knappen i en verktygsfältskontroll. |
TB_SETINSERTMARK | Anger den aktuella insättningsmarkeringen för verktygsfältet. |
TB_SETINSERTMARKCOLOR | Anger vilken färg som används för att rita insättningsmarkeringen för verktygsfältet. |
TB_SETLISTGAP | Anger avståndet mellan verktygsfältsknapparna i ett specifikt verktygsfält. |
TB_SETMAXTEXTROWS | Anger det maximala antalet textrader som visas i en verktygsfältsknapp. |
TB_SETMETRICS | Anger måtten för en verktygsfältskontroll. |
TB_SETPADDING | Anger utfyllnad för en verktygsfältskontroll. |
TB_SETPARENT | Anger det fönster som verktygsfältskontrollen skickar meddelandekoder till. |
TB_SETPRESSEDIMAGELIST | Anger den bildlista som verktygsfältet använder för att visa knappar som är i ett pressat tillstånd. |
TB_SETROWS | Anger antalet rader med knappar i ett verktygsfält. |
TB_SETSTATE | Anger tillståndet för den angivna knappen i ett verktygsfält. |
TB_SETSTYLE | Anger formatmallen för en verktygsfältskontroll. |
TB_SETTOOLTIPS | Associerar en knappbeskrivningskontroll med ett verktygsfält. |
TB_SETUNICODEFORMAT | Anger unicode-teckenformatflaggan för kontrollen. Med det här meddelandet kan du ändra den teckenuppsättning som används av kontrollen vid körning i stället för att behöva återskapa kontrollen. |
TB_SETWINDOWTHEME | Anger det visuella formatet för en verktygsfältskontroll. |
TB_TRANSLATEACCELERATOR | Skickar ett tangentbordsmeddelande till verktygsfältet. |
Meddelanden
Ämne | Innehåll |
---|---|
NM_CHAR (verktygsfält) | Skickas av verktygsfältet när det tar emot ett WM_CHAR meddelande. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
NM_CLICK (verktygsfält) | Skickas av en verktygsfältskontroll när användaren klickar på ett objekt med den vänstra musknappen. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
NM_CUSTOMDRAW (verktygsfält) | Skickas av verktygsfältet för att meddela dess överordnade fönster om ritningsåtgärder. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
NM_DBLCLK (verktygsfält) | Meddelar det överordnade fönstret i en verktygsfältskontroll att användaren har dubbelklickat på den vänstra musknappen i kontrollen. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
NM_KEYDOWN (verktygsfält) | Skickas av en kontroll när kontrollen har tangentbordsfokus och användaren trycker på en tangent. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
NM_LDOWN | Meddelar ett överordnat fönster i verktygsfältet att den vänstra musknappen har tryckts på. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
NM_RCLICK (verktygsfält) | Skickas av en verktygsfältskontroll när användaren klickar på verktygsfältet med höger musknapp. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
NM_RDBLCLK (verktygsfält) | Meddelar en kontrolls överordnade fönster att användaren har dubbelklickat på den högra musknappen i kontrollen. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
NM_RELEASEDCAPTURE (verktygsfält) | Meddelar en verktygsfältskontrolls överordnade fönster att kontrollen släpper musfångst. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
NM_TOOLTIPSCREATED (verktygsfält) | Meddelar verktygsfältets överordnade fönster att verktygsfältet har skapat en knappbeskrivningskontroll. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_BEGINADJUST | Meddelar ett överordnat fönster i verktygsfältet att användaren har börjat anpassa ett verktygsfält. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_BEGINDRAG | Meddelar ett överordnat fönster i verktygsfältet att användaren har börjat dra en knapp i ett verktygsfält. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_CUSTHELP | Meddelar ett överordnat fönster i verktygsfältet att användaren har valt hjälpknappen i dialogrutan Anpassa verktygsfält. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_DELETINGBUTTON | Skickas av en verktygsfältskontroll när en knapp är på väg att tas bort. |
TBN_DRAGOUT | Skickas av en verktygsfältskontroll när användaren klickar på en knapp och sedan flyttar markören från knappen. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_DRAGOVER | Kontrollerar om ett TB_MARKBUTTON meddelande ska skickas för en knapp som dras över. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_DROPDOWN | Skickas av en verktygsfältskontroll när användaren klickar på en listruteknapp. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_DUPACCELERATOR | Kontrollerar om en acceleratornyckel kan användas i två eller flera aktiva verktygsfält. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_ENDADJUST | Meddelar ett överordnat fönster i verktygsfältet att användaren har slutat anpassa ett verktygsfält. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_ENDDRAG | Meddelar verktygsfältets överordnade fönster att användaren har slutat dra en knapp i ett verktygsfält. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_GETBUTTONINFO | Hämtar anpassningsinformation för verktygsfältet och meddelar verktygsfältets överordnade fönster om eventuella ändringar som görs i verktygsfältet. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_GETDISPINFO | Hämtar visningsinformation för ett verktygsfältsobjekt. Det här meddelandet skickas i form av ett WM_NOTIFY meddelande. |
TBN_GETINFOTIP | Hämtar informationstipsinformation för ett verktygsfältsobjekt. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_GETOBJECT | Skickas av en verktygsfältskontroll som använder TBSTYLE_REGISTERDROP formatmall för att begära ett släppmålobjekt när pekaren passerar över en av knapparna. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_HOTITEMCHANGE | Skickas av en verktygsfältskontroll när det heta (markerade) objektet ändras. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_INITCUSTOMIZE | Meddelar ett överordnat fönster i verktygsfältet att anpassningen har startat. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_MAPACCELERATOR | Begär indexet för knappen i verktygsfältet som motsvarar det angivna acceleratortecknet. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_QUERYDELETE | Meddelar verktygsfältets överordnade fönster om en knapp kan tas bort från ett verktygsfält medan användaren anpassar verktygsfältet. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_QUERYINSERT | Meddelar verktygsfältets överordnade fönster om en knapp kan infogas till vänster om den angivna knappen medan användaren anpassar ett verktygsfält. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_RESET | Meddelar verktygsfältets överordnade fönster att användaren har återställt innehållet i dialogrutan Anpassa verktygsfält. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_RESTORE | Meddelar ett överordnat fönster i verktygsfältet att ett verktygsfält håller på att återställas. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_SAVE | Meddelar ett överordnat fönster i verktygsfältet att ett verktygsfält håller på att sparas. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_TOOLBARCHANGE | Meddelar verktygsfältets överordnade fönster att användaren har anpassat ett verktygsfält. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_WRAPACCELERATOR | Begär indexet för knappen i ett eller flera verktygsfält som motsvarar det angivna acceleratortecknet. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
TBN_WRAPHOTITEM | Meddelar ett program med två eller flera verktygsfält att det heta objektet håller på att ändras. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande. |
Strukturer
Ämne | Innehåll |
---|---|
COLORMAP- | Innehåller information som används av funktionen CreateMappedBitmap för att mappa bitmappens färger. |
NMTBCUSTOMDRAW | Innehåller information som är specifik för en NM_CUSTOMDRAW meddelandekod som skickas av en verktygsfältskontroll. |
NMTBDISPINFO | Innehåller och tar emot visningsinformation för ett verktygsfältsobjekt. Den här strukturen används med TBN_GETDISPINFO-meddelandekoden. |
NMTBGETINFOTIP- | Innehåller och tar emot informationstipsinformation för ett verktygsfältsobjekt. Den här strukturen används med TBN_GETINFOTIP meddelandekod. |
NMTBHOTITEM | Innehåller information som används med TBN_HOTITEMCHANGE meddelandekod. |
NMTBRESTORE | Gör att program kan extrahera den information som placerades i NMTBSAVE- när verktygsfältets tillstånd sparades. Den här strukturen skickas till program när de får en TBN_RESTORE meddelandekod. |
NMTBSAVE | Den här strukturen skickas till program när de får en TBN_SAVE meddelandekod. Den innehåller information om knappen som för närvarande sparas. Program kan ändra medlemmarnas värden för att spara ytterligare information. |
NMTOOLBAR | Innehåller information som används för att bearbeta meddelandekoder i verktygsfältet. Den här strukturen ersätter TBNOTIFY- struktur. |
TBADDBITMAP | Lägger till en bitmapp som innehåller knappbilder i ett verktygsfält. |
TBBUTTON- | Innehåller information om en knapp i ett verktygsfält. |
TBBUTTONINFO | Innehåller eller tar emot information om en specifik knapp i ett verktygsfält. |
TBINSERTMARK- | Innehåller information om insättningsmarkeringen i en verktygsfältskontroll. |
TBMETRICS | Definierar måtten för ett verktygsfält som används för att krympa eller expandera verktygsfältsobjekt. |
TBREPLACEBITMAP | Används med meddelandet TB_REPLACEBITMAP för att ersätta en bitmapp i verktygsfältet med en annan. |
TBSAVEPARAMS | Anger den plats i registret där TB_SAVERESTORE-meddelandet lagrar och hämtar information om tillståndet för ett verktygsfält. |
Konstanter
Ämne | Innehåll |
---|---|
knapptillstånd i verktygsfältet | I det här avsnittet visas de tillstånd som en verktygsfältsknapp kan ha. |
kontroll- och knappformat i verktygsfältet | Följande fönsterformat är specifika för verktygsfält. De kombineras med andra fönsterformat när verktygsfältet skapas. Note For Common Controls version 6.00, om ett visuellt format används med verktygsfältet, är knapparna alltid transparenta oavsett formatinställning. Annars är transparensbeteendet normalt, vilket indikeras av användningen av TBSTYLE_FLAT eller TBSTYLE_TRANSPARENT formatmall. Obs! Comctl32.dll version 6 kan inte omdistribueras, men den ingår i Windows eller senare. Om du vill använda Comctl32.dll version 6 anger du den i ett manifest. Mer information om manifest finns i Aktivera visuella format. |
Utökade formatmallar i verktygsfältet | I det här avsnittet visas de utökade format som stöds av verktygsfältskontroller. |
standardvärde för standardknappsbildindex i verktygsfältet | Det här avsnittet anger indexvärden för bilder i standard bitmappar. |