CToolBarCtrl osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

A Windows eszköztár általános vezérlőjének funkcióit biztosítja.

Szemantika

class CToolBarCtrl : public CWnd

Tagok

Nyilvános konstruktorok

Név	Description
CToolBarCtrl::CToolBarCtrl	Egy CToolBarCtrl objektumot hoz létre.

Nyilvános metódusok

Név	Description
CToolBarCtrl::AddBitmap	Egy vagy több bitkép gombképet ad hozzá az eszköztár-vezérlőkhöz elérhető gombképek listájához.
CToolBarCtrl::AddButtons	Egy vagy több gombot ad hozzá egy eszköztár vezérlőelemhez.
CToolBarCtrl::AddString	Új, erőforrás-azonosítóként átadott sztringet ad hozzá az eszköztár belső sztringlistájához.
CToolBarCtrl::AddStrings	Hozzáad egy új sztringet vagy sztringet, amely mutatóként van átadva a -separated strings pufferének NULL, az eszköztár belső sztringlistájához.
CToolBarCtrl::AutoSize	Átméretez egy eszköztár vezérlőelemet.
CToolBarCtrl::ChangeBitmap	Módosítja egy gomb bitképét az aktuális eszköztár vezérlőelemben.
CToolBarCtrl::CheckButton	Egy adott gombot ellenőriz vagy töröl egy eszköztár vezérlőelemben.
CToolBarCtrl::CommandToIndex	Lekéri a megadott parancsazonosítóhoz társított gomb nullaalapú indexét.
CToolBarCtrl::Create	Létrehoz egy eszköztár-vezérlőt, és csatolja egy CToolBarCtrl objektumhoz.
CToolBarCtrl::CreateEx	Létrehoz egy eszköztár-vezérlőt a megadott Bővített Windows-stílusokkal, és csatolja azt egy CToolBarCtrl objektumhoz.
CToolBarCtrl::Customize	Megjeleníti az Eszköztár testreszabása párbeszédpanelt.
CToolBarCtrl::DeleteButton	Gomb törlése az eszköztár vezérlőelemből.
CToolBarCtrl::EnableButton	Engedélyezi vagy letiltja a megadott gombot egy eszköztár-vezérlőben.
CToolBarCtrl::GetAnchorHighlight	Lekéri az eszköztár horgonykiemelési beállítását.
CToolBarCtrl::GetBitmap	Lekéri az eszköztár egy gombjához társított bitkép indexét.
CToolBarCtrl::GetBitmapFlags	Lekéri az eszköztár bitképéhez társított jelzőket.
CToolBarCtrl::GetButton	A megadott gomb adatainak lekérése egy eszköztár-vezérlőben.
CToolBarCtrl::GetButtonCount	Lekéri az eszköztár vezérlőelemben jelenleg található gombok számát.
CToolBarCtrl::GetButtonInfo	Lekéri az eszköztár egy gombjának adatait.
CToolBarCtrl::GetButtonSize	Az eszköztárgombok aktuális szélességét és magasságát kéri le képpontban.
CToolBarCtrl::GetColorScheme	Lekéri az aktuális eszköztár vezérlőelem színsémát.
CToolBarCtrl::GetDisabledImageList	Lekéri azt a képlistát, amelyet egy eszköztár-vezérlő használ a letiltott gombok megjelenítéséhez.
CToolBarCtrl::GetDropTarget	Lekéri az IDropTarget eszköztár vezérlőelem felületét.
CToolBarCtrl::GetExtendedStyle	Lekéri az eszköztár vezérlőelem kiterjesztett stílusait.
CToolBarCtrl::GetHotImageList	Lekéri azt a képlistát, amelyet az eszköztár-vezérlő a "gyakori" gombok megjelenítéséhez használ. Egy gyorsbillentyű jelenik meg, amely akkor jelenik meg, ha az egérmutató fölötte van.
CToolBarCtrl::GetHotItem	Lekéri a gyakori elemet tartalmazó indexet egy eszköztárban.
CToolBarCtrl::GetImageList	Lekéri azt a képlistát, amellyel az eszköztár-vezérlők alapértelmezett állapotukban jelenítik meg a gombokat.
CToolBarCtrl::GetInsertMark	Lekéri az eszköztár aktuális beszúrási jelét.
CToolBarCtrl::GetInsertMarkColor	Lekéri az eszköztár beszúrási jelének rajzolásához használt színt.
CToolBarCtrl::GetItemRect	Egy gomb határoló téglalapját kéri le egy eszköztár vezérlőelemben.
CToolBarCtrl::GetMaxSize	Lekéri az eszköztár összes látható gombjának és elválasztó elemének teljes méretét.
CToolBarCtrl::GetMaxTextRows	Lekéri az eszköztárgombon megjelenített szövegsorok maximális számát.
CToolBarCtrl::GetMetrics	Lekéri egy eszköztár vezérlőelem metrikáit.
CToolBarCtrl::GetPadding	Lekéri az aktuális eszköztár vezérlőelem vízszintes és függőleges kitöltését.
CToolBarCtrl::GetPressedImageList	Lekéri azt a képlistát, amelyet az aktuális eszköztár-vezérlő a lenyomott állapotban lévő gombok megjelenítésére használ.
CToolBarCtrl::GetRect	Lekéri egy adott eszköztárgomb határolókeretét.
CToolBarCtrl::GetRows	Lekéri az eszköztáron jelenleg megjelenő gombok sorainak számát.
CToolBarCtrl::GetState	A megadott gomb állapotával kapcsolatos információkat kér le egy eszköztár vezérlőelemben, például azt, hogy engedélyezve, lenyomva vagy bejelölve van-e.
CToolBarCtrl::GetString	Beolvas egy eszköztár-sztringet.
CToolBarCtrl::GetStyle	Lekéri az eszköztár vezérlőelemhez jelenleg használt stílusokat.
CToolBarCtrl::GetToolTips	Lekéri az eszköztár vezérlőelemhez társított eszköztipp vezérlőelem (ha van ilyen) fogópontját.
CToolBarCtrl::HideButton	Elrejti vagy megjeleníti a megadott gombot egy eszköztár vezérlőelemben.
CToolBarCtrl::HitTest	Meghatározza, hogy hol található egy pont egy eszköztár vezérlőelemben.
CToolBarCtrl::Indeterminate	Beállítja vagy törli a megadott gomb meghatározatlan (szürke) állapotát egy eszköztár vezérlőelemben.
CToolBarCtrl::InsertButton	Gomb beszúrása egy eszköztár vezérlőelembe.
CToolBarCtrl::InsertMarkHitTest	Beolvassa az eszköztár egy pontjának beszúrási jeladatait.
CToolBarCtrl::IsButtonChecked	Azt jelzi, hogy a megadott gomb be van-e jelölve egy eszköztár vezérlőelemben.
CToolBarCtrl::IsButtonEnabled	Azt jelzi, hogy engedélyezve van-e a megadott gomb egy eszköztár-vezérlőben.
CToolBarCtrl::IsButtonHidden	Azt jelzi, hogy az eszköztár vezérlőelemben megadott gomb rejtett-e.
CToolBarCtrl::IsButtonHighlighted	Ellenőrzi az eszköztár gomb kiemelési állapotát.
CToolBarCtrl::IsButtonIndeterminate	Azt jelzi, hogy a megadott gomb állapota egy eszköztár vezérlőelemben határozatlan (szürke).
CToolBarCtrl::IsButtonPressed	Azt jelzi, hogy az eszköztár vezérlőelem megadott gombja be van-e nyomva.
CToolBarCtrl::LoadImages	Bitképek betöltése egy eszköztár vezérlőelem képlistájába.
CToolBarCtrl::MapAccelerator	Egy gyorsító karaktert egy eszköztárgombra képez le.
CToolBarCtrl::MarkButton	Egy adott gomb kiemelési állapotát állítja be egy eszköztár vezérlőelemben.
CToolBarCtrl::MoveButton	Gomb áthelyezése egyik indexből a másikba.
CToolBarCtrl::PressButton	Lenyomja vagy felengedi a megadott gombot egy eszköztár vezérlőelemben.
CToolBarCtrl::ReplaceBitmap	Az aktuális eszköztár vezérlőelem meglévő bitképét lecseréli egy új bitképre.
CToolBarCtrl::RestoreState	Visszaállítja az eszköztár vezérlőelem állapotát.
CToolBarCtrl::SaveState	Menti az eszköztár vezérlőelem állapotát.
CToolBarCtrl::SetAnchorHighlight	Beállítja az eszköztár horgonykiemelési beállítását.
CToolBarCtrl::SetBitmapSize	Beállítja az eszköztár vezérlőelemhez hozzáadni kívánt bitképek méretét.
CToolBarCtrl::SetButtonInfo	Egy meglévő gomb információinak beállítása egy eszköztáron.
CToolBarCtrl::SetButtonSize	Beállítja az eszköztár vezérlőelemhez hozzáadni kívánt gombok méretét.
CToolBarCtrl::SetButtonStructSize	A struktúra méretét TBBUTTON adja meg.
CToolBarCtrl::SetButtonWidth	Beállítja az eszköztár vezérlőelem minimális és maximális gombszélességeit.
CToolBarCtrl::SetCmdID	Beállítja a parancsazonosítót, amelyet a megadott gomb lenyomásakor el kell küldeni a tulajdonosi ablaknak.
CToolBarCtrl::SetColorScheme	Beállítja az aktuális eszköztár vezérlőelem színsémát.
CToolBarCtrl::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.
CToolBarCtrl::SetDrawTextFlags	Beállítja a Win32 függvény DrawTextjelölőit, amelyek a megadott téglalapban lévő szöveg rajzolására szolgálnak, a jelölők beállításának megfelelően formázva.
CToolBarCtrl::SetExtendedStyle	Az eszköztár vezérlőelem kiterjesztett stílusainak beállítása.
CToolBarCtrl::SetHotImageList	Beállítja azt a képlistát, amelyet az eszköztár-vezérlő a "gyakori" gombok megjelenítésére fog használni.
CToolBarCtrl::SetHotItem	A gyakori elemet egy eszköztáron állítja be.
CToolBarCtrl::SetImageList	Beállítja azt a képlistát, amelyet az eszköztár az alapértelmezett állapotban lévő gombok megjelenítésére fog használni.
CToolBarCtrl::SetIndent	Az eszköztár vezérlőelem első gombjának behúzását állítja be.
CToolBarCtrl::SetInsertMark	Beállítja az eszköztár aktuális beszúrási jelét.
CToolBarCtrl::SetInsertMarkColor	Beállítja az eszköztár beszúrási jelének rajzolásához használt színt.
CToolBarCtrl::SetMaxTextRows	Az eszköztárgombon megjelenített szövegsorok maximális számát adja meg.
CToolBarCtrl::SetMetrics	Egy eszköztár vezérlőelem metrikáit állítja be.
CToolBarCtrl::SetOwner	Beállítja az ablakot, hogy értesítési üzeneteket fogadjon az eszköztár vezérlőelemből.
CToolBarCtrl::SetPadding	Az aktuális eszköztár vezérlőelem vízszintes és függőleges kitöltését állítja be.
CToolBarCtrl::SetPressedImageList	Beállítja azt a képlistát, amelyet az aktuális eszköztár-vezérlő a lenyomott állapotban lévő gombok megjelenítésére használ.
CToolBarCtrl::SetRows	Az eszköztáron megjelenő gombok sorainak számát állítja be.
CToolBarCtrl::SetState	Beállítja a megadott gomb állapotát egy eszköztár vezérlőelemben.
CToolBarCtrl::SetStyle	Beállítja az eszköztár vezérlőelem stílusát.
CToolBarCtrl::SetToolTips	Eszköztipp vezérlőelem társítása az eszköztár vezérlőelemmel.
CToolBarCtrl::SetWindowTheme	Beállítja egy eszköztár vezérlőelem vizuális stílusát.

Megjegyzések

Ez a vezérlő (és így az CToolBarCtrl osztály) csak a Windows 95/98 és a Windows NT 3.51-es és újabb verzióiban futó programokhoz érhető el.

A Windows eszköztár gyakori vezérlője egy téglalap alakú gyermekablak, amely egy vagy több gombot tartalmaz. Ezek a gombok bitképképet, sztringet vagy mindkettőt jeleníthetnek meg. Amikor a felhasználó kiválaszt egy gombot, egy parancsüzenetet küld az eszköztár tulajdonosi ablakának. Az eszköztár gombjai általában az alkalmazás menüjében található elemeknek felelnek meg; közvetlenebb módot biztosítanak a felhasználó számára az alkalmazás parancsainak elérésére.

CToolBarCtrl Az objektumok számos fontos belső adatstruktúrát tartalmaznak: a gombképek bitképeinek vagy képlistáinak listáját, a gombcímkék sztringjeinek listáját, valamint azoknak a struktúráknak a listáját TBBUTTON , amelyek egy képet és/vagy sztringet társítanak a gomb helyzetéhez, stílusához, állapotához és parancsazonosítóihoz. Ezeknek az adatstruktúráknak minden elemére nulla alapú index hivatkozik. Mielőtt használhatja az objektumot CToolBarCtrl , be kell állítania ezeket az adatstruktúrát. A sztringek listája csak gombcímkékhez használható; nem tud sztringeket lekérni az eszköztárról.

Objektum használatához CToolBarCtrl általában az alábbi lépéseket kell követnie:

1. Hozza létre az CToolBarCtrl objektumot.

2. Hívja meg Create a Windows eszköztár általános vezérlőjének létrehozását és az CToolBarCtrl objektumhoz való csatolását. Az eszköztár stílusának megjelölése stílusok használatával, például TBSTYLE_TRANSPARENT áttetsző vagy TBSTYLE_DROPDOWN legördülő stílusgombokat támogató eszköztár esetén.

3. Határozza meg, hogyan jelenjenek meg az eszköztár gombjai:

   • Ha bitképképeket szeretne használni a gombokhoz, adja hozzá a gomb bitképeit az eszköztárhoz hívással AddBitmap.

   • Ha gombokat szeretne használni egy képlistából, adja meg a képlistát hívással SetImageList, SetHotImageListvagy SetDisabledImageList.

   • Ha sztringfeliratokat szeretne használni a gombokhoz, adja hozzá a sztringeket az eszköztárhoz hívással AddString és/vagy AddStrings.

4. Gombstruktúrák hozzáadása az eszköztárhoz hívással AddButtons.

5. Ha nem a tulajdonosablakban lévő eszköztárgombhoz szeretne eszköztippeket CFrameWndhasználni, akkor az TTN_NEEDTEXT eszköztár tulajdonosablakában lévő üzeneteket az Eszköztipp-értesítések kezelése című szakaszban leírtak szerint kell kezelnie. Ha az eszköztár szülőablaka származik CFrameWnd, az eszköztippek minden további erőfeszítés nélkül megjelennek, mert CFrameWnd alapértelmezett kezelőt biztosít.

6. Ha azt szeretné, hogy a felhasználó testre szabhassa az eszköztárat, kezelje a testreszabási értesítési üzeneteket a tulajdonosablakban a Testreszabási értesítések kezelése című szakaszban leírtak szerint.

A SaveState beállításjegyzékben lévő eszköztár-vezérlők aktuális állapotát mentheti, és RestoreState visszaállíthatja az állapotot a beállításjegyzékben korábban tárolt információk alapján. Az eszköztár állapotának az alkalmazás használata közötti mentése mellett az alkalmazások általában azelőtt tárolják az állapotot, mielőtt a felhasználó elkezdené testre szabni az eszköztárat, ha a felhasználó később vissza szeretné állítani az eszköztárat az eredeti állapotára.

Az Internet Explorer 4.0-s és újabb verzióinak támogatása

Az Internet Explorer 4.0-s és újabb verziójában bevezetett funkciók támogatásához az MFC képlista-támogatást, valamint áttetsző és lapos stílusokat biztosít az eszköztár-vezérlőkhöz.

A transzparens eszköztár lehetővé teszi, hogy az eszköztár alatt lévő ügyfél megjelenítse azokat. Transzparens eszköztár létrehozásához használja mind a stílusokat, mind TBSTYLE_FLAT a TBSTYLE_TRANSPARENT stílusokat. A transzparens eszköztárak gyakori elérésű nyomkövetéssel rendelkeznek; vagyis amikor az egérmutató az eszköztár egy gyakori gombja fölé kerül, a gomb megjelenése megváltozik. A stílussal TBSTYLE_FLAT létrehozott eszköztárak nem átlátszó gombokat tartalmaznak.

A képlista támogatása nagyobb rugalmasságot biztosít az alapértelmezett viselkedéshez, a gyakori képekhez és a letiltott képekhez. GetHotImageListAz GetImageListáttetsző eszköztár használatával és GetDisabledImageList az áttetsző eszköztárral az állapotának megfelelően módosíthatja a képet:

A használatról CToolBarCtrltovábbi információt a Vezérlők és a Használat CToolBarCtrlcímű témakörben talál.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CToolBarCtrl

Requirements

Fejléc:afxcmn.h

CToolBarCtrl::AddBitmap

Egy vagy több gombképet ad hozzá az eszköztár vezérlőelemben tárolt gombképek listájához.

int AddBitmap(
    int nNumButtons,
    UINT nBitmapID);

int AddBitmap(
    int nNumButtons,
    CBitmap* pBitmap);

Paraméterek

nNumButtons
A bitképben lévő gombképek száma.

nBitmapID
A hozzáadni kívánt gombképet vagy képeket tartalmazó bitkép erőforrás-azonosítója.

pBitmap
Mutasson a CBitmap hozzáadni kívánt gombképet vagy képeket tartalmazó objektumra.

Visszaadott érték

Az első új rendszerkép nulla alapú indexe, ha sikeres; egyéb esetben - 1.

Megjegyzések

A Windows API-val CreateMappedBitmap színeket képezhet le, mielőtt hozzáadja a bitképet az eszköztárhoz. Ha mutatót ad át egy CBitMap objektumnak, győződjön meg arról, hogy a bitkép csak az eszköztár megsemmisülése után lesz megsemmisítve.

CToolBarCtrl::AddButtons

Egy vagy több gombot ad hozzá egy eszköztár vezérlőelemhez.

BOOL AddButtons(
    int nNumButtons,
    LPTBBUTTON lpButtons);

Paraméterek

nNumButtons
Hozzáadandó gombok száma.

lpButtons
A hozzáadni kívánt gombokra vonatkozó információkat tartalmazó struktúrák tömbjének TBBUTTON címe. A tömbben ugyanannyi elemnek kell lennie, mint a gomb által nNumButtonsmegadottnak.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

Az lpButtons egérmutató struktúrák tömbje TBBUTTON felé mutat. Minden TBBUTTON struktúra a gomb stílusával, képével és/vagy sztringjével, parancsazonosítójával, állapotával és felhasználó által megadott adataival társítja a hozzáadott gombot:

typedef struct _TBBUTTON {
    int iBitmap;    // zero-based index of button image
    int idCommand;  // command to be sent when button pressed
    BYTE fsState;   // button state--see below
    BYTE fsStyle;   // button style--see below
    DWORD dwData;   // application-defined value
    int iString;    // zero-based index of button label string
} TBBUTTON;

A tagok a következők:

• iBitmap

  A gomb képének nullaalapú indexe -1, ha ehhez a gombhoz nincs kép.

• idCommand

  A gombhoz társított parancsazonosító. Ezt az azonosítót a rendszer egy WM_COMMAND üzenetben küldi el a gomb kiválasztásakor. Ha a fsStyle tag rendelkezik az értékkel, ennek a TBSTYLE_SEP tagnak nullának kell lennie.

• fsState

  Gombállapot-jelzők. Az alábbi értékek kombinációja lehet:

  • TBSTATE_CHECKED A gomb stílusa TBSTYLE_CHECKED meg van nyomva.

  • TBSTATE_ENABLED A gomb elfogadja a felhasználói bemenetet. Egy olyan gomb, amely nem rendelkezik ezzel az állapotmal, nem fogadja el a felhasználói bemenetet, és szürkés színű.

  • TBSTATE_HIDDEN A gomb nem látható, és nem tud felhasználói bemenetet fogadni.

  • TBSTATE_INDETERMINATE A gomb szürkítve jelenik meg.

  • TBSTATE_PRESSED A gomb megnyomása folyamatban van.

  • TBSTATE_WRAP Egy sortörés követi a gombot. A gombnak is rendelkeznie kell az állapotával TBSTATE_ENABLED .

• fsStyle

  Gombstílus. Az alábbi értékek kombinációja lehet:

  • TBSTYLE_BUTTON Szabványos leküldéses gombot hoz létre.

  • TBSTYLE_CHECK Létrehoz egy gombot, amely minden kattintáskor vált a lenyomott és a lenyomatlan állapot között. A gomb háttérszíne eltérő, ha megnyomott állapotban van.

  • TBSTYLE_CHECKGROUP Létrehoz egy ellenőrző gombot, amely addig marad lenyomva, amíg a csoport egy másik gombja nem lesz lenyomva.

  • TBSTYLE_GROUP Létrehoz egy gombot, amely addig marad lenyomva, amíg a csoport egy másik gombja nem lesz lenyomva.

  • TBSTYLE_SEP Létrehoz egy elválasztót, amely kis rést biztosít a gombcsoportok között. Az ilyen stílusú gombok nem kapnak felhasználói bemenetet.

• dwData

  Felhasználó által definiált adatok.

• iString

  A gomb címkéjeként használandó sztring nullaalapú indexe -1, ha nincs sztring ehhez a gombhoz.

A megadott indexet tartalmazó képnek és/vagy sztringnek korábban hozzá kell adnia az eszköztár-vezérlőelem listájához a következő használatával AddBitmap: , AddStringés/vagy AddStrings.

CToolBarCtrl::AddString

Új, erőforrás-azonosítóként átadott sztringet ad hozzá az eszköztár belső sztringlistájához.

int AddString(UINT nStringID);

Paraméterek

nStringID
Az eszköztár vezérlőelem sztringlistájához hozzáadni kívánt sztringerőforrás erőforrás-azonosítója.

Visszaadott érték

Az első új sztring nulla alapú indexe, ha sikeres; egyéb esetben -1.

CToolBarCtrl::AddStrings

Új sztringet vagy sztringeket ad hozzá az eszköztár-vezérlőkhöz elérhető sztringek listájához.

int AddStrings(LPCTSTR lpszStrings);

Paraméterek

lpszStrings
Az eszköztár sztringlistájához hozzáadni kívánt egy vagy több NULLleállított sztringet tartalmazó puffer címe. Az utolsó sztringet két NULL karakterrel kell megszakítani.

Visszaadott érték

Az első új sztring nulla alapú indexe, ha sikeres; egyéb esetben -1.

Megjegyzések

A pufferben lévő sztringeket karakterrel NULL kell elválasztani. Győződjön meg arról, hogy az utolsó sztring két NULL terminátort tartalmaz. Az állandó sztringek megfelelő formázásához a következőképpen írhatja:

// one null added automatically
lpszStrings = _T("Only one string to add\0");

or:

// adds three strings with one call
lpszStrings = _T("String 1\0String 2\0String 3\0");

Nem szabad objektumot CString átadni ennek a függvénynek, mivel egynél több NULL karakter nem lehet a CStringfüggvényben.

CToolBarCtrl::AutoSize

Átméretezi a teljes eszköztár vezérlőelemet.

void AutoSize();

Megjegyzések

Ezt a függvényt akkor kell meghívni, ha a szülőablak mérete megváltozik, vagy ha az eszköztár mérete megváltozik (például amikor beállítja a gombot vagy a bitkép méretét, vagy sztringeket ad hozzá).

CToolBarCtrl::ChangeBitmap

Módosítja egy gomb bitképét az aktuális eszköztár vezérlőelemben.

BOOL ChangeBitmap(
    int idButton,
    int iBitmap);

Paraméterek

idButton
[in] Az új bitkép fogadásához szükséges gomb parancsazonosítója.

iBitmap
[in] Egy kép nullaalapú indexe az aktuális eszköztár vezérlőjének képlistájában.

Visszaadott érték

TRUEha ez a módszer sikeres; egyéb esetben. FALSE

Megjegyzések

Ha ez a módszer sikeres, a rendszer megjeleníti a megadott képet a megadott gombon.

Ez a metódus elküldi a TB_CHANGEBITMAP Windows SDK-ban leírt üzenetet.

Example

Az alábbi kódpéldában a Fájl mentése gomb bitképe a Névjegy gomb bitképére változik.

{
   // Change the bitmap for the File Save button, whose
   // command ID is ID_FILE_SAVE, to the bitmap for the
   // About button, whose index is 7.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ChangeBitmap(ID_FILE_SAVE, 7);
}

CToolBarCtrl::CheckButton

Egy adott gombot ellenőriz vagy töröl egy eszköztár vezérlőelemben.

BOOL CheckButton(
    int nID,
    BOOL bCheck = TRUE);

Paraméterek

nID
A gomb parancsazonosítója az ellenőrzéshez vagy törléshez.

bCheck
TRUE a gomb ellenőrzéséhez, FALSE törléséhez.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

Ha egy gombot ellenőriztek, úgy tűnik, hogy a gombot lenyomták. Ha egynél több gombállapotot szeretne módosítani, fontolja meg a hívásokat SetState .

CToolBarCtrl::CommandToIndex

Lekéri a megadott parancsazonosítóhoz társított gomb nullaalapú indexét.

UINT CommandToIndex(UINT nID) const;

Paraméterek

nID
Parancsazonosító, amelynek a gombindexét meg szeretné keresni.

Visszaadott érték

A parancsazonosítóhoz társított gomb nullaalapú indexe.

Megjegyzések

CToolBarCtrl::Create

Létrehoz egy eszköztár-vezérlőt, és csatolja egy CToolBarCtrl objektumhoz.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Paraméterek

dwStyle
Az eszköztár vezérlőelem stílusát adja meg. Az eszköztáraknak mindig a stílusuknak kell lenniük WS_CHILD . Emellett az eszköztárstílusok és az ablakstílusok tetszőleges kombinációját is megadhatja a Megjegyzések szakaszban leírtak szerint.

rect
Opcionálisan megadja az eszköztár vezérlőelem méretét és pozícióját. CRect Lehet objektum vagy RECT struktúra.

pParentWnd
Az eszköztár vezérlőelem szülőablakát adja meg. Nem lehet NULL.

nID
Megadja az eszköztár vezérlőelem azonosítóját.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

Két lépésben hozhat létre egy CToolBarCtrl elemet. Először hívja meg a konstruktort, majd hívja meg Create, amely létrehozza az eszköztár-vezérlőt, és csatolja az CToolBarCtrl objektumhoz. Alkalmazza az alábbi ablakstílusokat egy eszköztár vezérlőelemre.

• WS_CHILD Mindig

• WS_VISIBLE Általában

• WS_DISABLED Ritkán

Az ablakstílusok leírását a Windows SDK-ban találhatja CreateWindow meg.

A Windows SDK-ban leírtaknak megfelelően alkalmazhatja a gyakori vezérlőstílusok kombinációját.

Eszköztárstílusok kombinációját alkalmazhatja a vezérlőre vagy magukra a gombokra. A stílusokat a Windows SDK Eszköztárvezérlő és Gombstílusok című témakör ismerteti.

Ha bővített eszköztárstílusokat szeretne használni, hívja SetExtendedStyle fel a hívás Createután. Ha bővített ablakstílusokat tartalmazó eszköztárat szeretne létrehozni, hívja meg ahelyettCreate, hogy a CToolBarCtrl::CreateEx .

Az eszköztár vezérlőelem automatikusan beállítja az eszköztárablak méretét és pozícióját. A magasság az eszköztár gombjainak magasságán alapul. A szélesség megegyezik a szülőablak ügyfélterületének szélességével. CCS_BOTTOM A CCS_TOP stílusok határozzák meg, hogy az eszköztár az ügyfélterület tetején vagy alján helyezkedik-e el. Az eszköztár alapértelmezés szerint stílussal rendelkezik CCS_TOP .

CToolBarCtrl::CreateEx

Létrehoz egy vezérlőt (egy gyermekablakot), és társítja azt az CToolBarCtrl objektummal.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Paraméterek

dwExStyle
A létrehozott vezérlőelem kiterjesztett stílusát adja meg. A bővített Windows-stílusok listáját a dwExStyle Windows SDK paraméterében CreateWindowEx találja.

dwStyle
Az eszköztár vezérlőelem stílusát adja meg. Az eszköztáraknak mindig a stílusuknak kell lenniük WS_CHILD . Emellett az eszköztárstílusok és az ablakstílusok tetszőleges kombinációját is megadhatja a megjegyzések szakaszában Createleírtak szerint.

rect
Hivatkozás a RECT létrehozandó ablak méretét és pozícióját leíró struktúrára a következő ügyfélkoordinátáiban pParentWnd: .

pParentWnd
A vezérlő szülőablakára mutató mutató.

nID
A vezérlő gyermekablak-azonosítója.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Create A CreateEx bővített Windows-stílusok helyett használja a Windows bővített stílus előszavában WS_EX_megadott stílusokat. CreateEx a vezérlőt a megadott kiterjesztett Windows-stílusokkal dwExStylehozza létre. A vezérlőelemre jellemző kiterjesztett stílusok beállítása a következővel SetExtendedStyle: . Például az olyan stílusok beállítására használható CreateEx , mint WS_EX_CONTEXTHELPpéldául a , de az olyan stílusok beállítására, SetExtendedStyle mint a TBSTYLE_EX_DRAWDDARROWS. További információkért tekintse meg a Windows SDK-ban a Bővített eszköztár stílusok című témakört.

CToolBarCtrl::CToolBarCtrl

Egy CToolBarCtrl objektumot hoz létre.

CToolBarCtrl();

Megjegyzések

Ahhoz, hogy az eszköztár használható legyen, fel kell hívnia Create .

CToolBarCtrl::Customize

Megjeleníti az Eszköztár testreszabása párbeszédpanelt.

void Customize();

Megjegyzések

Ez a párbeszédpanel lehetővé teszi, hogy a felhasználó gombok hozzáadásával és törlésével testre szabja az eszköztárat. A testreszabás támogatásához az eszköztár szülőablakának kell kezelnie a testreszabási értesítési üzeneteket a Testreszabási értesítések kezelése című szakaszban leírtak szerint. Az eszköztárnak is létre kell hoznia a CCS_ADJUSTABLE stílust, az alábbiakban CToolBarCtrl::Createleírtak szerint.

CToolBarCtrl::DeleteButton

Gomb törlése az eszköztár vezérlőelemből.

BOOL DeleteButton(int nIndex);

Paraméterek

nIndex
A törölni kívánt gomb nullaalapú indexe.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

CToolBarCtrl::EnableButton

Engedélyezi vagy letiltja a megadott gombot egy eszköztár-vezérlőben.

BOOL EnableButton(
    int nID,
    BOOL bEnable = TRUE);

Paraméterek

nID
A gomb parancsazonosítója az engedélyezéshez vagy letiltásához.

bEnable
TRUE a gomb engedélyezéséhez; FALSE gomb letiltásához.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

Ha egy gomb engedélyezve van, lenyomható és ellenőrizhető. Ha egynél több gombállapotot szeretne módosítani, fontolja meg a hívásokat SetState .

CToolBarCtrl::GetAnchorHighlight

Lekéri az eszköztár horgonykiemelési beállítását.

BOOL GetAnchorHighlight() const;

Visszaadott érték

Nonzero esetén a horgonykiemelés engedélyezve van. Ha nulla, a horgonykiemelés le van tiltva.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_GETANCHORHIGHLIGHTviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::GetBitmap

Lekéri az eszköztár egy gombjához társított bitkép indexét.

int GetBitmap(int nID) const;

Paraméterek

nID
Annak a gombnak a parancsazonosítója, amelynek bitképindexét le kell kérni.

Visszaadott érték

A bitkép indexét adja eredményül, ha sikeres, vagy ellenkező esetben nullát.

Megjegyzések

Implementálja a Windows SDK funkcióit TB_GETBITMAP .

CToolBarCtrl::GetBitmapFlags

Lekéri a bitképjelzőket az eszköztárról.

UINT GetBitmapFlags() const;

Visszaadott érték

Ha UINT a megjelenítés támogatja a TBBF_LARGE nagy eszköztár-bitképeket, akkor a jelölő van beállítva, ellenkező esetben törölje a jelölést.

Megjegyzések

Az eszköztár létrehozása után, de mielőtt bitképeket ad hozzá az eszköztárhoz, hívja meg. A visszatérési érték azt jelzi, hogy a megjelenítés támogatja-e a nagy bitképeket. Ha a kijelző támogatja a nagy méretű bitképeket, és ha úgy dönt, hogy használja őket, hívja fel SetBitmapSize a nagy bitképet, és SetButtonSize mielőtt hozzáadja a nagy bitképet AddBitmap.

CToolBarCtrl::GetButton

A megadott gomb adatainak lekérése egy eszköztár-vezérlőben.

BOOL GetButton(
    int nIndex,
    LPTBBUTTON lpButton) const;

Paraméterek

nIndex
Annak a gombnak a nullaalapú indexe, amelyhez adatokat szeretne lekérni.

lpButton
Annak a struktúranak a TBBUTTON címe, amely a gombinformációk másolatát szeretné megkapni. A struktúrával kapcsolatos TBBUTTON információkért lásdCToolBarCtrl::AddButtons.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

CToolBarCtrl::GetButtonCount

Lekéri az eszköztár vezérlőelemben jelenleg található gombok számát.

int GetButtonCount() const;

Visszaadott érték

A gombok száma.

CToolBarCtrl::GetButtonInfo

Lekéri az eszköztár egy gombjának adatait.

int GetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi) const;

Paraméterek

nID
A gomb azonosítója.

ptbbi
A gombinformációkat fogadó struktúra mutatója TBBUTTONINFO .

Visszaadott érték

A gomb nulla alapú indexe, ha sikeres; egyéb esetben -1.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_GETBUTTONINFOviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::GetButtonSize

Lekéri az eszköztár méretét.

DWORD GetButtonSize() const;

Visszaadott érték

Olyan DWORD érték, amely a szélességi és magassági értékeket tartalmazza az és HIWORDa LOWORD .

CToolBarCtrl::GetButtonText

Lekéri egy adott gomb megjelenítendő szövegét az aktuális eszköztár vezérlőelemen.

CString GetButtonText(int idButton) const;

Paraméterek

idButton
[in] Annak a gombnak az azonosítója, amelynek a megjelenítendő szövegét lekéri.

Visszaadott érték

A CString megadott gomb megjelenítendő szövegét tartalmazó szöveg.

Megjegyzések

Ez a metódus elküldi a TB_GETBUTTONTEXT Windows SDK-ban leírt üzenetet.

CToolBarCtrl::GetColorScheme

Lekéri az aktuális eszköztár vezérlőelem színsémát.

BOOL GetColorScheme(COLORSCHEME* lpColorScheme) const;

Paraméterek

lpColorScheme
[kifelé] Mutasson egy COLORSCHEME olyan struktúrára, amely megkapja a színséma adatait. Amikor ez a módszer visszatér, a struktúra az eszköztár vezérlőelem kiemelési színét és árnyékszínét írja le.

Visszaadott érték

TRUEha ez a módszer sikeres; egyéb esetben. FALSE

Megjegyzések

Ez a metódus elküldi a TB_GETCOLORSCHEME Windows SDK-ban leírt üzenetet.

CToolBarCtrl::GetDisabledImageList

Lekéri azt a képlistát, amelyet egy eszköztár-vezérlő használ a letiltott gombok megjelenítéséhez.

CImageList* GetDisabledImageList() const;

Visszaadott érték

Egy objektumra CImageList mutató mutató, vagy NULL ha nincs beállítva letiltott képlista.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_GETDISABLEDIMAGELISTviselkedését a Windows SDK-ban leírtak szerint. Az MFC implementációja GetDisabledImageList egy CImageList objektumot használ, amely az eszköztár vezérlőelemének gombképeit tartalmazza, nem pedig egy képlista leíróját.

CToolBarCtrl::GetDropTarget

Lekéri az IDropTarget eszköztár vezérlőelem felületét.

HRESULT GetDropTarget(IDropTarget** ppDropTarget) const;

Paraméterek

ppDropTarget
Egy illesztőmutatóra IDropTarget mutató mutató. Hiba esetén a címben egy NULL mutató jelenik meg.

Visszaadott érték

HRESULT A művelet sikerességét vagy sikertelenségét jelző értéket ad vissza.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_GETOBJECTviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::GetExtendedStyle

Lekéri az eszköztár vezérlőelem kiterjesztett stílusait.

DWORD GetExtendedStyle() const;

Visszaadott érték

Az DWORD eszköztár vezérlőelemhez jelenleg használt kiterjesztett stílusokat ábrázoló beállítás. A stílusok listáját a Bővített eszköztár stílusai című témakörben találja a Windows SDK-ban.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_GETEXTENDEDSTYLEviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::GetHotImageList

Lekéri azt a képlistát, amelyet az eszköztár-vezérlő a "gyakori" gombok megjelenítéséhez használ. Egy gyorsbillentyű jelenik meg, amely akkor jelenik meg, ha az egérmutató fölötte van.

CImageList* GetHotImageList() const;

Visszaadott érték

Egy objektumra CImageList mutató mutató, vagy NULL ha nincs beállítva letiltott képlista.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_GETHOTIMAGELISTviselkedését a Windows SDK-ban leírtak szerint. Egy gyorsbillentyű jelenik meg, amely akkor jelenik meg, ha az egérmutató fölötte van.

CToolBarCtrl::GetHotItem

Lekéri a gyakori elemet tartalmazó indexet egy eszköztárban.

int GetHotItem() const;

Visszaadott érték

A gyakori elemet tartalmazó eszköztár nulla alapú indexe.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_GETHOTITEMviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::GetImageList

Lekéri azt a képlistát, amellyel az eszköztár-vezérlők alapértelmezett állapotukban jelenítik meg a gombokat.

CImageList* GetImageList() const;

Visszaadott érték

Egy objektumra mutató CImageList mutató, vagy NULL ha nincs beállítva képlista.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_GETIMAGELISTviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::GetInsertMark

Lekéri az eszköztár aktuális beszúrási jelét.

void GetInsertMark(TBINSERTMARK* ptbim) const;

Paraméterek

ptbim
Mutató egy TBINSERTMARK olyan struktúrához, amely megkapja a beszúrási jelet.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_GETINSERTMARKviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::GetInsertMarkColor

Lekéri az eszköztár beszúrási jelének rajzolásához használt színt.

COLORREF GetInsertMarkColor() const;

Visszaadott érték

Az COLORREF aktuális beszúrási jel színét tartalmazó érték.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_GETINSERTMARKCOLORviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::GetItemRect

Egy gomb határoló téglalapját kéri le egy eszköztár vezérlőelemben.

BOOL GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Paraméterek

nIndex
Annak a gombnak a nullaalapú indexe, amelyhez adatokat szeretne lekérni.

lpRect
A RECT határoló téglalap koordinátáit fogadó struktúra vagy CRect objektum címe.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

Ez a függvény nem kéri le a határoló téglalapot azokhoz a gombokhoz, amelyeknek az állapota be TBSTATE_HIDDENvan állítva.

CToolBarCtrl::GetMaxSize

Lekéri az eszköztár összes látható gombjának és elválasztó elemének teljes méretét.

BOOL GetMaxSize(LPSIZE pSize) const;

Paraméterek

pSize
Az elemek méretét fogadó struktúra mutatója SIZE .

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_GETMAXSIZEviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::GetMaxTextRows

Lekéri az eszköztárgombon megjelenített szövegsorok maximális számát.

int GetMaxTextRows() const;

Visszaadott érték

Az eszköztárgombon megjelenített szövegsorok maximális száma.

CToolBarCtrl::GetMetrics

Lekéri az objektum metrikáit CToolBarCtrl .

void GetMetrics(LPTBMETRICS ptbm) const;

Paraméterek

ptbm
Az objektum szerkezetére CToolBarCtrl mutató mutatóTBMETRICS.

Megjegyzések

Ez a tagfüggvény a Windows SDK-ban leírtak szerint emulálja az TB_GETMETRICS üzenet funkcióit.

CToolBarCtrl::GetPadding

Lekéri az aktuális eszköztár vezérlőelem vízszintes és függőleges kitöltését.

BOOL GetPadding(
    int* pnHorzPadding,
    int* pnVertPadding) const;

Paraméterek

pnHorzPadding
[kifelé] Egy egész szám, amely képpontban fogadja az eszköztár vezérlőelem vízszintes kitöltését.

pnVertPadding
[kifelé] Az eszköztár vezérlőelem függőleges kitöltését képpontban fogadó egész szám.

Visszaadott érték

TRUEha ez a módszer sikeres; egyéb esetben. FALSE

Megjegyzések

Ez a metódus elküldi a TB_GETPADDING Windows SDK-ban leírt üzenetet.

CToolBarCtrl::GetPressedImageList

Lekéri azt a képlistát, amelyet az aktuális eszköztár-vezérlő a lenyomott állapotban lévő gombok megjelenítésére használ.

CImageList* GetPressedImageList();

Visszaadott érték

Mutasson az CImageList aktuális vezérlő képlistáját tartalmazó lapra, vagy NULL ha nincs beállítva ilyen képlista.

Megjegyzések

Ez a metódus elküldi a TB_GETPRESSEDIMAGELIST Windows SDK-ban leírt üzenetet.

CToolBarCtrl::GetRect

Lekéri egy adott eszköztárgomb határolókeretét.

BOOL GetRect(
    int nID,
    LPRECT lpRect) const;

Paraméterek

nID
A gomb azonosítója.

lpRect
Mutató egy RECT szerkezetre a határoló téglalap információinak fogadásához.

Visszaadott érték

sikeres TRUE; egyéb esetben FALSE.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_GETRECTviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::GetRows

Lekéri az eszköztár vezérlőelem által jelenleg megjelenített gombok sorainak számát.

int GetRows() const;

Visszaadott érték

Az eszköztáron jelenleg megjelenő gombsorok száma.

Megjegyzések

Vegye figyelembe, hogy a sorok száma mindig egy lesz, kivéve, ha az eszköztárat a TBSTYLE_WRAPABLE stílussal hozták létre.

CToolBarCtrl::GetState

A megadott gomb állapotával kapcsolatos információkat kér le egy eszköztár vezérlőelemben, például azt, hogy engedélyezve, lenyomva vagy bejelölve van-e.

int GetState(int nID) const;

Paraméterek

nID
Annak a gombnak a parancsazonosítója, amelyhez adatokat szeretne lekérni.

Visszaadott érték

A gombállapot adatai, ha sikeresek, vagy ha más -1. A gombállapot-információk a listában felsorolt értékek kombinációját is tartalmazhatják CToolBarCtrl::AddButtons.

Megjegyzések

Ez a függvény különösen hasznos, ha egynél több gombállapotot szeretne lekérni. Ha csak egy állapotot szeretne lekérni, használja a következő tagfüggvények egyikét: IsButtonEnabled, IsButtonChecked, IsButtonPressed, IsButtonHiddenvagy IsButtonIndeterminate. A GetState gombállapot észlelésének egyetlen módja azonban a TBSTATE_WRAP tagfüggvény.

CToolBarCtrl::GetString

Beolvas egy eszköztár-sztringet.

int GetString(
    int nString,
    LPTSTR lpstrString,
    int cchMaxLen) const;

int GetString(
    int nString,
    CString& str) const;

Paraméterek

nString
A sztring indexe.

lpstrString
Mutató a sztring visszaadásához használt pufferre.

cchMaxLen
A puffer hossza bájtban.

str
A sztring.

Visszaadott érték

A sztring hossza, ha sikeres, -1, ha nem.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_GETSTRINGviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::GetStyle

Lekéri az eszköztár vezérlőelemre jelenleg alkalmazott stílusokat.

DWORD GetStyle() const;

Visszaadott érték

A DWORD Windows SDK-ban leírt eszköztár-vezérlési stílusok kombinációját tartalmazza.

CToolBarCtrl::GetToolTips

Lekéri az eszköztár vezérlőelemhez társított eszköztipp vezérlőelem (ha van ilyen) fogópontját.

CToolTipCtrl* GetToolTips() const;

Visszaadott érték

Az eszköztárhoz társított objektumra mutató mutató CToolTipCtrl , vagy NULL ha az eszköztár nem rendelkezik hozzá tartozó eszközleírás-vezérlővel.

Megjegyzések

Mivel az eszköztár vezérlőelem általában saját eszköztipp-vezérlőt hoz létre és tart fenn, a legtöbb programnak nem kell meghívnia ezt a függvényt.

CToolBarCtrl::HitTest

Meghatározza, hogy hol található egy pont egy eszköztár vezérlőelemben.

int HitTest(LPPOINT ppt) const;

Paraméterek

ppt
Mutató egy POINT struktúrára, amely tartalmazza a tagban x a találati teszt x koordinátáját és a tagban y lévő találati teszt y koordinátáját. A koordináták az eszköztár ügyfélterületéhez viszonyítva vannak.

Visszaadott érték

Egész szám, amely egy adott pont helyét jelzi az eszköztáron. Ha az érték nulla vagy pozitív érték, akkor ez a visszatérési érték annak a nem elválasztó elemnek a nullaalapú indexe, amelyben a pont található.

Ha a visszatérési érték negatív, a pont nem egy gombon belül van. A visszatérési érték abszolút értéke az elválasztó elem vagy a legközelebbi nem elválasztó elem indexe.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_HITTESTviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::HideButton

Elrejti vagy megjeleníti a megadott gombot egy eszköztár vezérlőelemben.

BOOL HideButton(
    int nID,
    BOOL bHide = TRUE);

Paraméterek

nID
Az elrejtendő vagy megjelenítendő gomb parancsazonosítója.

bHide
TRUE a gomb elrejtéséhez, FALSE megjelenítéséhez.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

Ha egynél több gombállapotot szeretne módosítani, fontolja meg a hívásokat SetState .

CToolBarCtrl::Indeterminate

Beállítja vagy törli a megadott gomb meghatározatlan állapotát egy eszköztár vezérlőelemben.

BOOL Indeterminate(
    int nID,
    BOOL bIndeterminate = TRUE);

Paraméterek

nID
Annak a gombnak a parancsazonosítója, amelynek meghatározhatatlan állapotát be kell állítani vagy törölni kell.

bIndeterminate
TRUE a megadott gomb határozatlan állapotának beállításához törölje FALSE azt.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

A meghatározatlan gombok szürkén jelennek meg, például a szövegszerkesztő eszköztárán megjelenő félkövér gomb megjelenése, ha a kijelölt szöveg félkövér és normál karaktereket is tartalmaz. Ha egynél több gombállapotot szeretne módosítani, fontolja meg a hívásokat SetState .

CToolBarCtrl::InsertButton

Gomb beszúrása egy eszköztár vezérlőelembe.

BOOL InsertButton(
    int nIndex,
    LPTBBUTTON lpButton);

Paraméterek

nIndex
Gomb nullaalapú indexe. Ez a függvény beszúrja az új gombot a gombtól balra.

lpButton
A TBBUTTON beszúrni kívánt gombbal kapcsolatos információkat tartalmazó struktúra címe. Tekintse meg CToolBarCtrl::AddButtons a TBBUTTON szerkezet leírását.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

A megadott indexet tartalmazó képnek és/vagy sztringnek korábban hozzá kell adnia az eszköztár-vezérlőelem listájához a következő használatával AddBitmap: , AddStringés/vagy AddStrings.

CToolBarCtrl::InsertMarkHitTest

Beolvassa az eszköztár egy pontjának beszúrási jeladatait.

BOOL InsertMarkHitTest(
    LPPOINT ppt,
    LPTBINSERTMARK ptbim) const;

Paraméterek

ppt
Mutató a POINT találati teszt koordinátáit tartalmazó struktúrára az eszköztár ügyfélterületéhez viszonyítva.

ptbim
Mutató egy TBINSERTMARK olyan struktúrára, amely megkapja a beszúrási jel adatait.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_INSERTMARKHITTESTviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::IsButtonChecked

Meghatározza, hogy az eszköztár vezérlőelemben megadott gomb be van-e jelölve.

BOOL IsButtonChecked(int nID) const;

Paraméterek

nID
Az eszköztár gombjának parancsazonosítója.

Visszaadott érték

Nonzero, ha a gomb be van jelölve; ellenkező esetben nulla.

Megjegyzések

Fontolja meg a hívásokat GetState , ha egynél több gombállapotot szeretne lekérni.

CToolBarCtrl::IsButtonEnabled

Meghatározza, hogy a megadott gomb engedélyezve van-e egy eszköztár-vezérlőben.

BOOL IsButtonEnabled(int nID) const;

Paraméterek

nID
Az eszköztár gombjának parancsazonosítója.

Visszaadott érték

Nonzero, ha a gomb engedélyezve van; ellenkező esetben nulla.

Megjegyzések

Fontolja meg a hívásokat GetState , ha egynél több gombállapotot szeretne lekérni.

CToolBarCtrl::IsButtonHidden

Meghatározza, hogy az eszköztár vezérlőelemben megadott gomb rejtett-e.

BOOL IsButtonHidden(int nID) const;

Paraméterek

nID
Az eszköztár gombjának parancsazonosítója.

Visszaadott érték

Nonzero, ha a gomb rejtett; ellenkező esetben nulla.

Megjegyzések

Fontolja meg a hívásokat GetState , ha egynél több gombállapotot szeretne lekérni.

CToolBarCtrl::IsButtonHighlighted

Az eszköztár gomb kiemelési állapotát ellenőrzi.

BOOL IsButtonHighlighted(int nID) const;

Paraméterek

nID
[in] Az eszköztár gomb parancsazonosítója.

Visszaadott érték

Pozitív egész szám, ha a gomb ki van emelve, 0, ha a gomb nincs kiemelve, vagy -1 hiba esetén.

CToolBarCtrl::IsButtonIndeterminate

Meghatározza, hogy az eszköztár vezérlőelemben megadott gomb meghatározatlan-e.

BOOL IsButtonIndeterminate(int nID) const;

Paraméterek

nID
[in] Az eszköztár gombjának parancsazonosítója.

Visszaadott érték

Pozitív egész szám, ha a gomb határozatlan, nulla, ha a gomb nem határozatlan, vagy hiba esetén -1.

Megjegyzések

A meghatározatlan gombok halványan jelennek meg, például a szövegszerkesztő eszköztárán lévő félkövér gomb megjelenése, ha a kijelölt szöveg félkövér és normál karaktereket is tartalmaz. Fontolja meg a hívásokat GetState , ha egynél több gombállapotot szeretne lekérni.

CToolBarCtrl::IsButtonPressed

Meghatározza, hogy a megadott gombot lenyomja-e egy eszköztár-vezérlő.

BOOL IsButtonPressed(int nID) const;

Paraméterek

nID
Az eszköztár gombjának parancsazonosítója.

Visszaadott érték

Nonzero, ha a gombot lenyomta, ellenkező esetben nulla.

Megjegyzések

Fontolja meg a hívásokat GetState , ha egynél több gombállapotot szeretne lekérni.

CToolBarCtrl::LoadImages

Bitképek betöltése egy eszköztár vezérlőelem képlistájába.

void LoadImages(
    int iBitmapID,
    HINSTANCE hinst);

Paraméterek

iBitmapID
A betöltendő képeket tartalmazó bitkép azonosítója. A saját bitképerőforrás megadásához állítsa ezt a paramétert egy bitkép típusú erőforrás azonosítójára, és állítsa a hInst következőre NULL: . A bitkép-erőforrás egyetlen képként lesz hozzáadva a képlistához. Szabványos, rendszer által definiált bitképeket úgy adhat hozzá, hogy HINST_COMMCTRL a paramétert a következő azonosítók egyikére állítja hinst be és állítja be:

Bitkép azonosítója	Description
IDB_HIST_LARGE_COLOR	Explorer-bitképek nagy méretben
IDB_HIST_SMALL_COLOR	Explorer-bitképek kis méretben
IDB_STD_LARGE_COLOR	Standard bitképek nagy méretben
IDB_STD_SMALL_COLOR	Standard bitképek kis méretben
IDB_VIEW_LARGE_COLOR	Bitképek megtekintése nagy méretben
IDB_VIEW_SMALL_COLOR	Bitképek megtekintése kis méretben

hinst
A programpéldány kezeli a hívó alkalmazást. Ez a paraméter lehet HINST_COMMCTRL egy szabványos képlista betöltése.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_LOADIMAGESviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::MapAccelerator

Egy gyorsító karaktert egy eszköztárgombra képez le.

BOOL MapAccelerator(
    TCHAR chAccel,
    UINT* pIDBtn);

Paraméterek

chAccel
Leképezendő gyorsító karakter. Ez a karakter ugyanaz, mint a gomb szövegében aláhúzott karakter.

pIDBtn
Egy mutató, UINT amely megkapja a gomb parancsazonosítóját, amely megfelel a megadott gyorsítónak chAccel.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_MAPACCELERATORviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::MarkButton

Egy adott gomb kiemelési állapotát állítja be egy eszköztár vezérlőelemben.

BOOL MarkButton(
    int nID,
    BOOL fHighlight = TRUE);

Paraméterek

nID
A gomb azonosítója.

fHighlight
Megadja a beállítani kívánt kiemelési állapotot. Alapértelmezés szerint. TRUE Ha be van FALSEállítva, a gomb az alapértelmezett állapotra van állítva.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_MARKBUTTONviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::MoveButton

Gomb áthelyezése egyik indexből a másikba.

BOOL MoveButton(
    UINT nOldPos,
    UINT nNewPos);

Paraméterek

nOldPos
Az áthelyezendő gomb nulla alapú indexe.

nNewPos
A gomb célhelyének nulla alapú indexe.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_MOVEBUTTONviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::PressButton

Lenyomja vagy felengedi a megadott gombot egy eszköztár vezérlőelemben.

BOOL PressButton(int nID, BOOL bPress = TRUE);

Paraméterek

nID
[in] A gomb parancsazonosítója a gomb megnyomásához vagy kiadásához.

bPress
[in] TRUE a megadott gomb megnyomásához; FALSE a megadott gomb felszabadításához. Az alapértelmezett érték a TRUE.

Visszaadott érték

TRUEha a módszer sikeres; egyéb esetben. FALSE

Megjegyzések

Ha egynél több gombállapotot szeretne módosítani, fontolja meg a hívásokat SetState .

Ez a metódus elküldi a TB_PRESSBUTTON Windows SDK-ban leírt üzenetet.

CToolBarCtrl::ReplaceBitmap

Az aktuális eszköztár vezérlőelem meglévő bitképét lecseréli egy új bitképre.

BOOL ReplaceBitmap(LPTBREPLACEBITMAP pReplaceBitmap);

Paraméterek

pReplaceBitmap
[in] Mutasson a TBREPLACEBITMAP lecserélendő bitképet és az új bitképet leíró struktúrára.

Visszaadott érték

TRUEha ez a módszer sikeres; egyéb esetben. FALSE

Megjegyzések

Ez a metódus elküldi a TB_REPLACEBITMAP Windows SDK-ban leírt üzenetet.

Example

Az alábbi példakód a normál eszköztár bitképét egy másik bitképre cseréli.

{
   // Replace one toolbar bitmap with another.
   TBREPLACEBITMAP tbrb;
   tbrb.hInstOld = ::AfxGetInstanceHandle();
   tbrb.nIDOld = IDR_MAINFRAME;
   tbrb.hInstNew = ::AfxGetInstanceHandle();
   tbrb.nIDNew = IDR_MAINFRAME1;
   tbrb.nButtons = 8;
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ReplaceBitmap(&tbrb);
}

CToolBarCtrl::RestoreState

Visszaállítja az eszköztár vezérlőelem állapotát a paraméterek által megadott beállításjegyzékbeli helyről.

void RestoreState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Paraméterek

hKeyRoot
Egy jelenleg megnyitott kulcsot azonosít a beállításjegyzékben, vagy az alábbi előre definiált fenntartott leíróértékek bármelyikét:

• HKEY_CLASSES_ROOT

• HKEY_CURRENT_USER

• HKEY_LOCAL_MACHINE

• HKEY_USERS

lpszSubKey
Egy -terminated sztringre NULLmutat, amely annak az alkulcsnak a nevét tartalmazza, amelyhez érték van társítva. Ez a paraméter lehet NULL üres sztring vagy mutató. Ha a paraméter az NULL, az érték hozzáadódik a paraméter által azonosított kulcshoz hKeyRoot .

lpszValueName
A lekérendő érték nevét tartalmazó sztringre mutat. Ha egy ilyen nevű érték még nem szerepel a kulcsban, a függvény hozzáadja azt a kulcshoz.

CToolBarCtrl::SaveState

Menti az eszköztár vezérlőelem állapotát a paraméterek által megadott beállításjegyzékbeli helyre.

void SaveState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Paraméterek

hKeyRoot
Egy jelenleg megnyitott kulcsot azonosít a beállításjegyzékben, vagy az alábbi előre definiált fenntartott leíróértékek bármelyikét:

• HKEY_CLASSES_ROOT

• HKEY_CURRENT_USER

• HKEY_LOCAL_MACHINE

• HKEY_USERS

lpszSubKey
Egy -terminated sztringre NULLmutat, amely annak az alkulcsnak a nevét tartalmazza, amelyhez érték van társítva. Ez a paraméter lehet NULL üres sztring vagy mutató. Ha a paraméter az NULL, az érték hozzáadódik a paraméter által azonosított kulcshoz hKeyRoot .

lpszValueName
A beállítandó érték nevét tartalmazó sztringre mutat. Ha egy ilyen nevű érték még nem szerepel a kulcsban, a függvény hozzáadja azt a kulcshoz.

CToolBarCtrl::SetAnchorHighlight

Beállítja az eszköztár horgonykiemelési beállítását.

BOOL SetAnchorHighlight(BOOL fAnchor = TRUE);

Paraméterek

fAnchor
[in] Megadja, hogy a horgonykiemelés engedélyezve van-e vagy le van-e tiltva. Ha ez az érték nem nulla, a horgonykiemelés engedélyezve lesz. Ha ez az érték nulla, a horgonykiemelés le lesz tiltva

Visszaadott érték

Az előző horgonybeállítás. Ha a kiemelés engedélyezve volt, ez az érték nem érték. Ha a kiemelés nem volt engedélyezve, ez az érték nulla.

Megjegyzések

Ez a metódus implementálja a Win32-üzenet TB_SETANCHORHIGHLIGHTviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::SetBitmapSize

Beállítja az eszköztár vezérlőelemhez hozzáadni kívánt tényleges bitképek méretét.

BOOL SetBitmapSize(CSize size);

Paraméterek

size
A bitképek szélessége és magassága képpontban.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

Ezt a függvényt csak akkor kell meghívni, ha bitképeket ad hozzá az eszköztárhoz. Ha az alkalmazás nem állítja be explicit módon a bitkép méretét, az alapértelmezés szerint 16 és 15 képpont.

CToolBarCtrl::SetButtonInfo

Egy meglévő gomb információinak beállítása egy eszköztáron.

BOOL SetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi);

Paraméterek

nID
A gomb azonosítója.

ptbbi
A gombinformációkat fogadó struktúra mutatója TBBUTTONINFO .

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A tagfüggvény implementálja a Win32-üzenet TB_SETBUTTONINFOviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::SetButtonSize

Az eszköztár vezérlőelem gombjainak méretét állítja be.

BOOL SetButtonSize(CSize size);

Paraméterek

size
A gombok szélessége és magassága képpontban.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

A gomb méretének mindig legalább akkoranak kell lennie, mint a benne lévő bitképméret. Ezt a függvényt csak akkor kell meghívni, ha bitképeket ad hozzá az eszköztárhoz. Ha az alkalmazás nem állítja be explicit módon a gomb méretét, alapértelmezés szerint 24 és 22 képpont között van.

Example

Lásd a példát a CToolBar::GetToolBarCtrl.

CToolBarCtrl::SetButtonStructSize

A struktúra méretét TBBUTTON adja meg.

void SetButtonStructSize(int nSize);

Paraméterek

nSize
A struktúra mérete bájtban TBBUTTON .

Megjegyzések

Ha további adatokat szeretne tárolni a TBBUTTON struktúrában, létrehozhat egy új struktúrát TBBUTTON, hozzáadhatja a szükséges tagokat, vagy létrehozhat egy új struktúrát, amely első tagként tartalmaz egy struktúrát TBBUTTON . Ezután meghívja ezt a függvényt, hogy tájékoztassa az eszköztárat az új struktúra méretének szabályozásáról.

További CToolBarCtrl::AddButtons információt a TBBUTTON struktúráról talál.

CToolBarCtrl::SetButtonWidth

Beállítja az eszköztár vezérlőelem minimális és maximális gombszélességeit.

BOOL SetButtonWidth(
    int cxMin,
    int cxMax);

Paraméterek

cxMin
Minimális gombszélesség képpontban. Az eszköztárgombok soha nem lesznek keskenyebbek ennél az értéknél.

cxMax
Gombszélesség maximális száma képpontban. Ha a gombszöveg túl széles, a vezérlőelem három ponttal jeleníti meg.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_SETBUTTONWIDTHviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::SetCmdID

Beállítja a parancsazonosítót, amelyet a megadott gomb lenyomásakor a rendszer a tulajdonosi ablakba küld.

BOOL SetCmdID(
    int nIndex,
    UINT nID);

Paraméterek

nIndex
Annak a gombnak a nullaalapú indexe, amelynek a parancsazonosítóját be kell állítani.

nID
A kijelölt gomb beállításához megadott parancsazonosító.

Visszaadott érték

Sikertelen értéket ad vissza, ha sikeres; ellenkező esetben nulla.

CToolBarCtrl::SetColorScheme

Beállítja az aktuális eszköztár vezérlőelem színsémát.

void SetColorScheme(const COLORSCHEME* lpColorScheme);

Paraméterek

lpColorScheme
[in] Mutató az COLORSCHEME eszköztár vezérlőelem kiemelési színét és árnyékszínét leíró szerkezetre.

Megjegyzések

Ennek a módszernek nincs hatása, ha Windows Vista-vizualizációs téma van beállítva.

Ez a metódus elküldi a TB_SETCOLORSCHEME Windows SDK-ban leírt üzenetet.

Example

Az alábbi példakód az aktuális eszköztár vezérlőelem színsémát állítja be. A példakód az egyes eszközgombok bal és felső szélét pirossá, a jobb és az alsó éleket pedig kékre állítja. Amikor a felhasználó megnyomja a gombot, a gomb piros szélei kékre változnak, kék szélei pedig pirosra változnak.

//Set color scheme for the current toolbar control.
//Make the left and top edges of the tool button red,
//and the right and bottom edges blue. The colors
//reverse when a button is pressed.
//This method has no effect if the Vista visual theme
//is set.
{
   COLORSCHEME cs;
   cs.dwSize = sizeof(COLORSCHEME);
   cs.clrBtnHighlight = RGB(255, 0, 0);
   cs.clrBtnShadow = RGB(0, 0, 255);
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetColorScheme(&cs);
}

CToolBarCtrl::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.

CImageList* SetDisabledImageList(CImageList* pImageList);

Paraméterek

pImageList
A letiltott gombképek megjelenítéséhez az eszköztár vezérlőelem által használandó képeket tartalmazó objektumra mutató mutató CImageList .

Visszaadott érték

Egy olyan objektumra CImageList mutató mutató, amelyet korábban az eszköztár-vezérlő használt a letiltott gombképek megjelenítéséhez.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_SETDISABLEDIMAGELISTviselkedését a Windows SDK-ban leírtak szerint. Az MFC implementációja SetDisabledImageList egy CImageList objektumot használ, amely az eszköztár vezérlőelem letiltott gombképeit tartalmazza, nem pedig egy leírót egy képlistához.

CToolBarCtrl::SetDrawTextFlags

Beállítja a Win32 függvény DrawTextjelölőit, amelyek a megadott téglalapban lévő szöveg rajzolására szolgálnak, a jelölők beállításának megfelelően formázva.

DWORD SetDrawTextFlags(
    DWORD dwMask,
    DWORD dwDTFlags);

Paraméterek

dwMask
A Win32 függvényben DrawTextmegadott egy vagy több DT_ jelölő kombinációja, amely azt jelzi, hogy mely bitek dwDTFlags lesznek használva a szöveg rajzolásakor.

dwDTFlags
A Win32 függvényben DrawTextmegadott egy vagy több DT_ jelölő kombinációja, amely jelzi a gomb szövegének rajzolását. Ez az érték a DrawText gomb szövegének rajzolásakor lesz átadva.

Visszaadott érték

Az DWORD előző szöveges rajzjelölőket tartalmazó.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_SETDRAWTEXTFLAGSviselkedését a Windows SDK-ban leírtak szerint. Ez a tagfüggvény a Win32 függvényben DrawTextállítja be a jelzőket, amelyek a megadott téglalapban rajzolják meg a szöveget a jelölők beállítása szerint formázva.

CToolBarCtrl::SetExtendedStyle

Az eszköztár vezérlőelem kiterjesztett stílusainak beállítása.

DWORD SetExtendedStyle(DWORD dwExStyle);

Paraméterek

dwExStyle
Az új kiterjesztett stílusokat meghatározó érték. Ez a paraméter az eszköztár bővített stílusainak kombinációja lehet.

Visszaadott érték

Az DWORD előző kiterjesztett stílusokat ábrázoló. A stílusok listáját a Bővített eszköztár stílusai című témakörben találja a Windows SDK-ban.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_SETEXTENDEDSTYLEviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::SetHotImageList

Beállítja azt a képlistát, amelyet az eszköztár-vezérlő a "gyakori" gombok megjelenítésére fog használni.

CImageList* SetHotImageList(CImageList* pImageList);

Paraméterek

pImageList
Egy olyan objektumra CImageList mutató mutató, amely tartalmazza az eszköztár-vezérlő által a gyakori elérésű gombos képek megjelenítéséhez használni kívánt képeket.

Visszaadott érték

Egy olyan objektumra CImageList mutató mutató, amelyet korábban az eszköztár-vezérlő használt a gyakori elérésű gombos képek megjelenítéséhez.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_SETHOTIMAGELISTviselkedését a Windows SDK-ban leírtak szerint.

Az MFC implementációja SetHotImageList egy CImageList objektumot használ, amely az eszköztár-vezérlő gyakori gombjainak képeit tartalmazza, nem pedig egy képlistához tartozó fogópontot. Egy gyorsbillentyű jelenik meg kiemelve, amikor az egérmutató fölötte van.

CToolBarCtrl::SetHotItem

A gyakori elemet egy eszköztáron állítja be.

int SetHotItem(int nHot);

Paraméterek

nHot
Az elem nullaalapú indexszáma, amelyet fel fog használni. Ha ez az érték -1, egyik elem sem lesz gyakori.

Visszaadott érték

Az előző gyakori elérésű elem indexe, vagy -1, ha nem volt gyakori elérésű elem.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_SETHOTITEMviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::SetImageList

Beállítja azt a képlistát, amelyet az eszköztár az alapértelmezett állapotban lévő gombok megjelenítésére fog használni.

CImageList* SetImageList(CImageList* pImageList);

Paraméterek

pImageList
Egy olyan objektumra CImageList mutató mutató, amely tartalmazza az eszköztár vezérlőelem által használandó képeket a gombképek alapértelmezett állapotban való megjelenítéséhez.

Visszaadott érték

Egy olyan objektumra CImageList mutató mutató, amelyet korábban az eszköztár-vezérlő használt a gombképek alapértelmezett állapotban való megjelenítéséhez.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_SETIMAGELISTviselkedését a Windows SDK-ban leírtak szerint.

Az MFC implementációja SetImageList egy CImageList objektumot használ, amely az eszköztár vezérlőelemének gombképeit tartalmazza, nem pedig egy képlista leíróját.

CToolBarCtrl::SetIndent

Az eszköztár vezérlőelem első gombjának behúzását állítja be.

BOOL SetIndent(int iIndent);

Paraméterek

iIndent
A behúzást képpontban meghatározó érték.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

CToolBarCtrl::SetInsertMark

Beállítja az eszköztár aktuális beszúrási jelét.

void SetInsertMark(TBINSERTMARK* ptbim);

Paraméterek

ptbim
A beszúrási TBINSERTMARK jelet tartalmazó struktúra mutatója.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_SETINSERTMARKviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::SetInsertMarkColor

Beállítja az eszköztár beszúrási jelének rajzolásához használt színt.

COLORREF SetInsertMarkColor(COLORREF clrNew);

Paraméterek

clrNew
Az COLORREF új beszúrási jel színét tartalmazó érték.

Visszaadott érték

Az COLORREF előző beszúrási jel színét tartalmazó érték.

Megjegyzések

Ez a tagfüggvény implementálja a Win32-üzenet TB_SETINSERTMARKCOLORviselkedését a Windows SDK-ban leírtak szerint.

CToolBarCtrl::SetMaxTextRows

Az eszköztárgombon megjelenített szövegsorok maximális számát adja meg.

BOOL SetMaxTextRows(int iMaxRows);

Paraméterek

iMaxRows
A beállítandó sorok maximális száma.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

CToolBarCtrl::SetMetrics

Beállítja az objektum metrikáit CToolBarCtrl .

void SetMetrics(LPTBMETRICS ptbm);

Paraméterek

ptbm
Az objektum szerkezetére CToolBarCtrl mutató mutatóTBMETRICS.

Megjegyzések

Ez a tagfüggvény a Windows SDK-ban leírtak szerint emulálja az TB_SETMETRICS üzenet funkcióit.

CToolBarCtrl::SetOwner

Beállítja az eszköztár vezérlőelem tulajdonosi ablakát.

void SetOwner(CWnd* pWnd);

Paraméterek

pWnd
Mutasson arra a CWnd vagy CWnd-származtatott objektumra, amely az eszköztár vezérlőelem új tulajdonosi ablaka lesz.

Megjegyzések

A tulajdonos ablaka az az ablak, amely értesítéseket fogad az eszköztárról.

CToolBarCtrl::SetPadding

Az aktuális eszköztár vezérlőelem vízszintes és függőleges kitöltését állítja be.

DWORD SetPadding(
    int nHorzPadding,
    int nVertPadding);

Paraméterek

nHorzPadding
[in] Az eszköztár vezérlőelem vízszintes kitöltését adja meg képpontban.

nVertPadding
[in] Az eszköztár vezérlőelem függőleges kitöltését adja meg képpontban.

Visszaadott érték

Az DWORD a szó, amelynek alacsony szója az előző vízszintes kitöltési értéket tartalmazza, és amelynek magas szava az előző függőleges párnázási értéket tartalmazza. A párnázási értékek képpontban vannak megmérve.

Megjegyzések

Ez a metódus elküldi a TB_SETPADDING Windows SDK-ban leírt üzenetet.

Example

Az alábbi példakód az aktuális eszköztár vezérlőelem vízszintes és függőleges kitöltését 20 képpontra állítja.

{
   // Set the horizontal and vertical padding of the current
   // toolbar control.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetPadding(50, 50);
}

CToolBarCtrl::SetPressedImageList

Beállítja azt a képlistát, amelyet az aktuális eszköztár-vezérlő a lenyomott állapotban lévő gombok megjelenítésére használ.

CImagelist* SetPressedImageList(
    int iImageID,
    CImageList* pImageList);

Paraméterek

iImageID
[in] A képlista nulla alapú indexe. Ha csak egy képlistát használ, állítsa ezt a paramétert nullára.

pImageList
[in] Mutasson az CImageList új képlistát tartalmazó lapra.

Visszaadott érték

Mutasson az CImageList aktuális vezérlő előző képlistáját tartalmazó listára, vagy NULL ha nincs beállítva ilyen képlista.

Megjegyzések

Ez a metódus elküldi a TB_SETPRESSEDIMAGELIST Windows SDK-ban leírt üzenetet.

Example

Az alábbi példakód úgy állítja be a lenyomott képlistát, hogy az megegyezik az alapértelmezett képlistával.

{
   // SetPressedImageList
   // Set the pressed image list to be the same as the
   // normal image list.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   CImageList *pNormalCil = m_toolBarCtrl.GetImageList();
   CImageList *pPressedCil = m_toolBarCtrl.GetPressedImageList();
   m_toolBarCtrl.SetPressedImageList(0, pNormalCil);
}

CToolBarCtrl::SetRows

Megkéri az eszköztár vezérlőelemet, hogy méretezze át magát a kért számú sorra.

void SetRows(
    int nRows,
    BOOL bLarger,
    LPRECT lpRect);

Paraméterek

nRows
Kért sorok száma.

bLarger
Azt jelzi, hogy több vagy kevesebb sort használjon-e, ha az eszköztár nem méretezhető át a kért számú sorra.

lpRect
Az eszköztár új határolókeretét fogadó objektumra CRect vagy RECT szerkezetre mutat.

Megjegyzések

Ha az eszköztár nem tudja átméretezni magát a kért számra vagy sorokra, akkor az értéktől bLargerfüggően a következő nagyobb vagy következő kisebb érvényes méretre méretezi át magát. Ha bLarger igen TRUE, az új sorok száma nagyobb lesz, mint a kért szám. Ha bLarger igen FALSE, az új sorok száma kisebb lesz, mint a kért szám.

Egy adott számú sor akkor érvényes az eszköztárra, ha a gombokat úgy lehet elrendezni, hogy az összes sor ugyanolyan számú gombot tartalmaz (kivéve talán az utolsó sort). Egy négy gombot tartalmazó eszköztár például nem méretezhető három sorra, mert az utolsó két sornak rövidebbnek kell lennie. Ha három sorra próbálta méretezni, akkor négy sort kap, ha bLarger volt TRUE , és két sort, ha bLarger volt FALSE.

Ha vannak elválasztójelek az eszköztárban, az adott számú sor érvényességének szabályai bonyolultabbak. Az elrendezés úgy van kiszámítva, hogy a gombcsoportok (a csoport első és utolsó gombja előtt elválasztó gombokkal rendelkező gombok) soha ne legyenek több sorra bontva, hacsak a csoport nem fér el egy sorban.

Ha egy csoport nem fér el egy sorban, a következő csoport akkor is a következő sorban indul el, ha az elfér azon a sorban, ahol a nagy csoport véget ért. Ennek a szabálynak az a célja, hogy észrevehetőbbé tegye a nagy csoportok elkülönítését. Az eredményül kapott függőleges elválasztó soroknak számít.

Vegye figyelembe azt is, hogy a SetRows tagfüggvény mindig a legkisebb eszköztárméretet eredményező elrendezést választja ki. Ha létrehoz egy eszköztárat a TBSTYLE_WRAPABLE stílussal, majd átméretezi a vezérlőt, egyszerűen alkalmazza a fent vázolt módszert a vezérlőelem szélessége alapján.

Ez a függvény csak a stílussal TBSTYLE_WRAPABLE létrehozott eszköztárakhoz hívható meg.

CToolBarCtrl::SetState

Beállítja a megadott gomb állapotát egy eszköztár vezérlőelemben.

BOOL SetState(
    int nID,
    UINT nState);

Paraméterek

nID
A gomb parancsazonosítója.

nState
Állapotjelzők. Ez lehet a gombállapotok CToolBarCtrl::AddButtonslistában szereplő értékek kombinációja.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben nulla.

Megjegyzések

Ez a függvény különösen hasznos, ha több gombállapotot is be szeretne állítani. Ha csak egy állapotot szeretne beállítani, használja az alábbi tagfüggvények egyikét: EnableButton, CheckButton, HideButton, Indeterminatevagy PressButton.

CToolBarCtrl::SetStyle

Beállítja az eszköztár vezérlőelem stílusát.

void SetStyle(DWORD dwStyle);

Paraméterek

dwStyle
A DWORD Windows SDK-ban leírt eszköztár-vezérlési stílusok kombinációját tartalmazza.

CToolBarCtrl::SetToolTips

Eszközleírás-vezérlő társítása eszköztár-vezérlővel.

void SetToolTips(CToolTipCtrl* pTip);

Paraméterek

pTip
Mutasson az CToolTipCtrl objektumra.

CToolBarCtrl::SetWindowTheme

Beállítja az objektum vizuális stílusát CToolBarCtrl .

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Paraméterek

pszSubAppName
Mutató egy Unicode-sztringre, amely tartalmazza a beállított eszköztár vizualizációs stílusát.

Visszaadott érték

A visszatérési érték nem használatos.

Megjegyzések

Ez a tagfüggvény a Windows SDK-ban leírtak szerint emulálja az TB_SETWINDOWTHEME üzenet funkcióit.

Lásd még

MFC-minta CMNCTRL1
MFC-minta MFCIE
CWnd osztály
hierarchiadiagram
CToolBar osztály