Megosztás a következőn keresztül:

CToolBar 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 bitleképezett gombokat és választható elválasztójeleket tartalmazó vezérlősávok.

Szemantika

class CToolBar : public CControlBar

Members

Nyilvános konstruktorok

Név Description
CToolBar::CToolBar Objektumot CToolBar hoz létre.

Nyilvános metódusok

Név Description
CToolBar::CommandToIndex Egy gomb indexét adja vissza a megadott parancsazonosítóval.
CToolBar::Create Létrehozza a Windows eszköztárat, és csatolja az CToolBar objektumhoz.
CToolBar::CreateEx Létrehoz egy CToolBar objektumot további stílusokkal a beágyazott CToolBarCtrl objektumhoz.
CToolBar::GetButtonInfo Lekéri egy gomb azonosítóját, stílusát és képszámát.
CToolBar::GetButtonStyle Lekéri egy gomb stílusát.
CToolBar::GetButtonText Lekéri a gombon megjelenő szöveget.
CToolBar::GetItemID Egy gomb vagy elválasztó parancsazonosítóját adja vissza az adott indexen.
CToolBar::GetItemRect Lekéri az adott indexben lévő elem megjelenítendő téglalapjait.
CToolBar::GetToolBarCtrl Lehetővé teszi a közvetlen hozzáférést a mögöttes közös vezérlőhöz.
CToolBar::LoadBitmap Betölti a bitképet tartalmazó bitképet.
CToolBar::LoadToolBar Betölti az erőforrásszerkesztővel létrehozott eszköztárerőforrást.
CToolBar::SetBitmap Bitleképet állít be.
CToolBar::SetButtonInfo Beállítja egy gomb azonosítóját, stílusát és képszámát.
CToolBar::SetButtons Beállítja a gombstílusokat és a gombképek indexét a bitképen belül.
CToolBar::SetButtonStyle Beállítja egy gomb stílusát.
CToolBar::SetButtonText Beállítja a gombon megjelenő szöveget.
CToolBar::SetHeight Beállítja az eszköztár magasságát.
CToolBar::SetSizes Beállítja a gombok és a bitképek méretét.

Megjegyzések

A gombok úgy viselkedhetnek, mint a nyomógombok, a jelölőnégyzetgombok vagy a választógombok. CToolBaraz objektumok általában az osztályból vagy CFrameWndaz osztályból CMDIFrameWnd származtatott keretablak-objektumok beágyazott tagjai.

CToolBar::GetToolBarCtrlaz MFC 4.0-s verziójában új tagfüggvény lehetővé teszi, hogy kihasználhassa a Windows általános vezérlő eszköztár-testreszabási és további funkcióinak támogatását. CToolBar a tagfüggvények a Windows általános vezérlőinek legtöbb funkcióját biztosítják; híváskor GetToolBarCtrlazonban még jobban megismerheti a Windows 95/98-eszköztárak jellemzőit. Amikor meghívja GetToolBarCtrl, az egy objektumra CToolBarCtrl mutató hivatkozást ad vissza. További CToolBarCtrl információ az eszköztárak windowsos általános vezérlőkkel való tervezéséről. A gyakori vezérlőkkel kapcsolatos általános információkért tekintse meg a Windows SDK Közös vezérlői című témakört.

A Visual Studio két módszert kínál az eszköztár létrehozásához. Ha eszköztárerőforrást szeretne létrehozni az Erőforrásszerkesztővel, kövesse az alábbi lépéseket:

  1. Hozzon létre egy eszköztárerőforrást.

  2. Hozza létre az CToolBar objektumot.

  3. Hívja meg a Create (vagy CreateEx) függvényt a Windows-eszköztár létrehozásához és az CToolBar objektumhoz való csatolásához.

  4. Hívás LoadToolBar az eszköztár-erőforrás betöltéséhez.

Ellenkező esetben kövesse az alábbi lépéseket:

  1. Hozza létre az CToolBar objektumot.

  2. Hívja meg a Create (vagy CreateEx) függvényt a Windows-eszköztár létrehozásához és az CToolBar objektumhoz való csatolásához.

  3. Hívás LoadBitmap az eszköztár gombképét tartalmazó bitkép betöltésére.

  4. Hívja SetButtons meg a gombstílust, és társítsa az egyes gombokat egy képhez a bitképen.

Az eszköztár összes gombképe egy bitképből származik, amelynek minden gombhoz egy képet kell tartalmaznia. Minden képnek azonos méretűnek kell lennie; az alapértelmezett érték 16 képpont széles és 15 képpont magas. A képeknek egymás mellett kell lenniük a bitképen.

A SetButtons függvény egy vezérlőazonosító-tömbre mutató mutatót és egy egész számot ad meg, amely meghatározza a tömb elemeinek számát. A függvény az egyes gombok azonosítóját a tömb megfelelő elemének értékére állítja, és minden gombhoz hozzárendel egy képindexet, amely meghatározza a gomb képének helyét a bittérképen. Ha egy tömbelem rendelkezik az értékkel ID_SEPARATOR, nincs hozzárendelve képindex.

A bittérképen lévő képek sorrendje általában az, hogy milyen sorrendben vannak rajzolva a képernyőn, de a SetButtonInfo függvény használatával módosíthatja a képsorrend és a rajzrend közötti kapcsolatot.

Az eszköztár összes gombja azonos méretű. Az alapértelmezett érték 24 x 22 képpont, a Windows felület szoftvertervezési irányelveinek megfelelően. A rendszer a kép és a gombméretek között további szóközöket használ a kép körüli szegély létrehozásához.

Minden gomb egy képpel rendelkezik. A különböző gombállapotok és stílusok (lenyomva, fel, le, letiltva, letiltva és meghatározhatatlanul) ebből az egyetlen képből jönnek létre. Bár a bitképek bármilyen színűek lehetnek, a legjobb eredményt fekete és szürke árnyalatú képekkel érheti el.

Figyelmeztetés

CToolBar legfeljebb 16 színnel támogatja a bitképeket. Amikor betölt egy képet egy eszköztár-szerkesztőbe, a Visual Studio automatikusan 16 színű bitképké alakítja a képet, ha szükséges, és figyelmeztető üzenetet jelenít meg a kép konvertálása esetén. Ha 16-nál több színt tartalmazó képet használ (külső szerkesztőt használ a kép szerkesztéséhez), előfordulhat, hogy az alkalmazás váratlanul viselkedik.

Az eszköztárgombok alapértelmezés szerint utánozza a nyomógombokat. Az eszköztárgombok azonban a jelölőnégyzet- vagy választógombokat is utánozhatják. A jelölőnégyzetgombok három állapottal rendelkeznek: bejelölve, törölve és meghatározhatatlanul. A választógomboknak csak két állapotuk van: bejelölve és törölve.

Ha egyéni gombot vagy elválasztó stílust szeretne beállítani tömbre mutatás nélkül, hívja GetButtonStyle meg a stílus lekérését, majd ahelyettSetButtonStyle, hogy a hívást.SetButtons SetButtonStyle akkor hasznos, ha futásidőben módosítani szeretné egy gomb stílusát.

Ha egy gombon megjelenítendő szöveget szeretne hozzárendelni, hívja GetButtonText meg a gombon megjelenő szöveg lekérését, majd hívja meg SetButtonText a szöveg beállításához.

Jelölőnégyzetgomb létrehozásához rendelje hozzá a stílust TBBS_CHECKBOX , vagy használja egy CCmdUI objektum tagfüggvényét SetCheck egy ON_UPDATE_COMMAND_UI kezelőben. A hívás SetCheck jelölőnégyzetgombmá változtatja a nyomógombot. Adjon meg SetCheck egy 0 argumentumot a nem bejelölt, 1 az ellenőrzött, a 2 pedig a határozatlan értékeket.

Választógomb létrehozásához hívja meg egy CCmdUI objektum tagfüggvényét SetRadio egy ON_UPDATE_COMMAND_UI kezelőtől. Adjon meg SetRadio egy 0 argumentumot a bejelöletlen vagy a nem ellenőrzött értékhez. A rádiócsoportok kölcsönösen kizáró viselkedésének biztosításához a csoport összes gombjának kezelőivel kell rendelkeznie ON_UPDATE_COMMAND_UI .

A használatról CToolBartovábbi információt az MFC eszköztár implementációja és a 31. technikai megjegyzés: Vezérlősávok című cikkben talál.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CControlBar

CToolBar

Requirements

Fejléc:afxext.h

CToolBar::CommandToIndex

Ez a tagfüggvény az első eszköztárgomb indexét adja vissza a 0. pozíciótól kezdve, amelynek parancsazonosítója megegyezik nIDFind.

int CommandToIndex(UINT nIDFind) const;

Paraméterek

nIDFind
Eszköztárgomb parancsazonosítója.

Visszaadott érték

A gomb indexe, vagy -1, ha egyetlen gomb sem rendelkezik a megadott parancsazonosítóval.

CToolBar::Create

Ez a tagfüggvény létrehoz egy Windows-eszköztárat (egy gyermekablakot), és társítja azt az CToolBar objektummal.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_TOOLBAR);

Paraméterek

pParentWnd
Mutasson arra az ablakra, amely az eszköztár szülője.

dwStyle
Az eszköztár stílusa. További támogatott eszköztárstílusok:

  • CBRS_TOP A vezérlősáv a keretablak tetején található.

  • CBRS_BOTTOM A vezérlősáv a keret ablakának alján található.

  • CBRS_NOALIGN A vezérlősáv nem lesz áthelyezve a szülő átméretezésekor.

  • CBRS_TOOLTIPS A vezérlősáv eszköztippeket jelenít meg.

  • CBRS_SIZE_DYNAMIC A vezérlősáv dinamikus.

  • CBRS_SIZE_FIXED A vezérlősáv ki van javítva.

  • CBRS_FLOATING A vezérlősáv lebegő.

  • CBRS_FLYBY Az állapotsor megjeleníti a gomb adatait.

  • CBRS_HIDE_INPLACE A vezérlősáv nem jelenik meg a felhasználó számára.

nID
Az eszköztár gyermekablak-azonosítója.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Az eszköztár magasságát is alapértelmezett értékre állítja.

Example

// This code fragment is taken from CMainFrame::OnCreate
// CMainFrame is derived from CMDIFrameWnd.

//This example creates a dockable toolbar.
if (!m_wndToolBar.Create(this) ||
   !m_wndToolBar.LoadToolBar(IDR_MAINFRAME))
{
   TRACE0("Failed to create toolbar\n");
   return -1;      // fail to create
}

//Make the toolbar dockable
m_wndToolBar.EnableDocking(CBRS_ALIGN_ANY);
EnableDocking(CBRS_ALIGN_ANY);
DockControlBar(&m_wndToolBar);

CToolBar::CreateEx

A függvény meghívásával hozzon létre egy Windows-eszköztárat (egy gyermekablakot), és társítsa azt az CToolBar objektummal.

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle = TBSTYLE_FLAT,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_ALIGN_TOP,
    CRect rcBorders = CRect(
    0,
    0,
    0,
    0),
    UINT nID = AFX_IDW_TOOLBAR);

Paraméterek

pParentWnd
Mutasson arra az ablakra, amely az eszköztár szülője.

dwCtrlStyle
További stílusok a beágyazott CToolBarCtrl objektum létrehozásához. Alapértelmezés szerint ez az érték a következőre TBSTYLE_FLATvan állítva: . Az eszköztárstílusok teljes listáját lásd: dwStyle.

dwStyle
Az eszköztár stílusa. A megfelelő stílusok listáját a Windows SDK eszköztár-vezérlői és gombstílusai között találja.

rcBorders
Az CRect eszköztár ablakszegélyeinek szélességét meghatározó objektum. Ezek a szegélyek alapértelmezés szerint 0,0,0,0 értékre vannak beállítva, ami egy eszköztárablakot eredményez szegély nélkül.

nID
Az eszköztár gyermekablak-azonosítója.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Az eszköztár magasságát is alapértelmezett értékre állítja.

Használja CreateExahelyett Create, hogy a beágyazott eszközsáv-vezérlő létrehozásakor bizonyos stílusokat jelen kellene lennie. Állítsa be például úgy, dwCtrlStyleTBSTYLE_FLAT | TBSTYLE_TRANSPARENT hogy az Internet Explorer 4 eszköztárához hasonló eszköztárat hozzon létre.

Example

// This example demonstrates CToolBar::CreateEx by creating a 
// toolbar as part of a child frame window. It also calls the 
// LoadToolbar and EnableDocking functions
int CChildFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
   if (CMDIChildWnd::OnCreate(lpCreateStruct) == -1)
      return -1;

   if (!m_wndMyToolBar.CreateEx(this, TBSTYLE_FLAT, WS_CHILD | WS_VISIBLE | CBRS_TOP
      | CBRS_GRIPPER | CBRS_TOOLTIPS | CBRS_FLYBY | CBRS_SIZE_DYNAMIC) ||
      !m_wndMyToolBar.LoadToolBar(IDR_MYTOOLBAR))
   {
      TRACE0("Failed to create toolbar\n");
      return -1;      // fail to create
   }

   m_wndMyToolBar.EnableDocking(CBRS_ALIGN_ANY);
   EnableDocking(CBRS_ALIGN_ANY);
   DockControlBar(&m_wndMyToolBar);

   return 0;
}

CToolBar::CToolBar

Ez a tagfüggvény létrehoz egy CToolBar objektumot, és beállítja az alapértelmezett méreteket.

CToolBar();

Megjegyzések

Hívja meg a Create tagfüggvényt az eszköztárablak létrehozásához.

CToolBar::GetButtonInfo

Ez a tagfüggvény lekéri az eszköztár gomb vagy elválasztó elem vezérlőazonosítóját, stílusát és képindexét a megadott nIndexhelyen.

void GetButtonInfo(
    int nIndex,
    UINT& nID,
    UINT& nStyle,
    int& iImage) const;

Paraméterek

nIndex
Annak az eszköztárgombnak vagy elválasztónak az indexe, amelynek adatait le kell kérni.

nID
Hivatkozás a gomb parancsazonosítójára beállított UINT-ra.

nStyle
Hivatkozás a gomb stílusára beállított UINT-ra.

iImage
Hivatkozás egy egész számra, amely a gomb képének indexére van állítva a bitképen belül.

Megjegyzések

Ezek az értékek a , nIDés nStyle.iImage A képindex a kép helye a bitképen belül, amely az összes eszköztárgomb képét tartalmazza. Az első kép a 0. pozícióban van.

Ha nIndex elválasztójelet ad meg, iImage akkor az elválasztó szélessége képpontban van beállítva.

CToolBar::GetButtonStyle

Ennek a tagfüggvénynek a meghívásával lekérheti egy gomb vagy elválasztó stílusát az eszköztáron.

UINT GetButtonStyle(int nIndex) const;

Paraméterek

nIndex
A lekérendő eszköztárgomb vagy elválasztó stílus indexe.

Visszaadott érték

A gomb vagy elválasztó stílusa.nIndex

Megjegyzések

A gomb stílusa határozza meg, hogyan jelenik meg a gomb, és hogyan reagál a felhasználói bemenetre. Példák SetButtonStyle a gombstílusokra.

CToolBar::GetButtonText

Hívja meg ezt a tagfüggvényt a gombon megjelenő szöveg lekéréséhez.

CString GetButtonText(int nIndex) const;

void GetButtonText(
    int nIndex,
    CString& rString) const;

Paraméterek

nIndex
A lekérendő szöveg indexe.

rString
A lekérendő szöveget tartalmazó objektumra mutató hivatkozás CString .

Visszaadott érték

A CString gomb szövegét tartalmazó objektum.

Megjegyzések

A tagfüggvény második formája kitölt egy objektumot a sztringszöveggel CString .

CToolBar::GetItemID

Ez a tagfüggvény a gomb vagy elválasztó által megadott parancsazonosítót nIndexadja vissza.

UINT GetItemID(int nIndex) const;

Paraméterek

nIndex
Annak az elemnek az indexe, amelynek azonosítóját le kell kérni.

Visszaadott érték

A gomb vagy elválasztó által megadott nIndexparancsazonosító.

Megjegyzések

Az elválasztójelek adnak vissza ID_SEPARATOR.

CToolBar::GetItemRect

Ez a tagfüggvény kitölti azt a RECT struktúrát, amelynek a címét a gomb vagy elválasztó által lpRectmegadott koordináták tartalmazzáknIndex.

virtual void GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Paraméterek

nIndex
Azon elem (gomb vagy elválasztó) indexe, amelynek téglalap koordinátáit le kell kérni.

lpRect
Az RECT elem koordinátáit tartalmazó struktúra címe.

Megjegyzések

A koordináták képpontban vannak az eszköztár bal felső sarkához képest.

Egy olyan elválasztó koordinátáinak lekérésére használható GetItemRect , amelyet kombinált listára vagy más vezérlőre szeretne cserélni.

Example

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

CToolBar::GetToolBarCtrl

Ez a tagfüggvény közvetlen hozzáférést biztosít a mögöttes közös vezérlőhöz.

CToolBarCtrl& GetToolBarCtrl() const;

Visszaadott érték

Egy objektumra mutató CToolBarCtrl hivatkozás.

Megjegyzések

A GetToolBarCtrl windowsos eszköztár általános vezérlő funkciójának kihasználására és a támogatás CToolBarCtrl kihasználására szolgáló eszközsor testreszabását teszi lehetővé.

A gyakori vezérlők használatáról további információt a Windows SDK Vezérlők és közös vezérlők című cikkében talál.

Example

// This code fragment is taken from CMainFrame::OnCreate
// CMainFrame is derived from CMDIFrameWnd.

//This example shows how to add text to toolbar buttons.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_FLAT, WS_CHILD | WS_VISIBLE
   | CBRS_TOP) || !m_wndToolBar.LoadToolBar(IDR_MAINFRAME))
{
   TRACE0("Failed to create toolbar\n");
   return -1;      // fail to create
}

//Show text on toolbar buttons.
VERIFY(m_wndToolBar.SetButtonText(0, _T("New")));
VERIFY(m_wndToolBar.SetButtonText(1, _T("Open")));
VERIFY(m_wndToolBar.SetButtonText(2, _T("Save")));
VERIFY(m_wndToolBar.SetButtonText(4, _T("Cut")));
VERIFY(m_wndToolBar.SetButtonText(5, _T("Copy")));
VERIFY(m_wndToolBar.SetButtonText(6, _T("Paste")));
VERIFY(m_wndToolBar.SetButtonText(8, _T("Print")));
VERIFY(m_wndToolBar.SetButtonText(9, _T("About")));

CRect temp;
m_wndToolBar.GetItemRect(0, &temp);
m_wndToolBar.GetToolBarCtrl().SetButtonSize(CSize(temp.Width(),
   temp.Height()));

CToolBar::LoadBitmap

Hívja meg ezt a tagfüggvényt a megadott lpszResourceName bitkép betöltéséhez.nIDResource

BOOL LoadBitmap(LPCTSTR lpszResourceName);
BOOL LoadBitmap(UINT nIDResource);

Paraméterek

lpszResourceName
Mutasson a betöltendő bitkép erőforrásnevére.

nIDResource
A betöltendő bitkép erőforrás-azonosítója.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A bitképnek minden egyes eszköztárgombhoz egy képet kell tartalmaznia. Ha a képek nem szabványos méretűek (16 képpont szélesek és 15 képpont magasak), hívja meg SetSizes a gombméreteket és azok képeit.

Figyelmeztetés

CToolBar legfeljebb 16 színnel támogatja a bitképeket. Amikor betölt egy képet egy eszköztár-szerkesztőbe, a Visual Studio automatikusan 16 színű bitképké alakítja a képet, ha szükséges, és figyelmeztető üzenetet jelenít meg a kép konvertálása esetén. Ha 16-nál több színt tartalmazó képet használ (külső szerkesztőt használ a kép szerkesztéséhez), előfordulhat, hogy az alkalmazás váratlanul viselkedik.

CToolBar::LoadToolBar

Hívja meg ezt a tagfüggvényt a megadott lpszResourceName eszköztár betöltéséhez.nIDResource

BOOL LoadToolBar(LPCTSTR lpszResourceName);
BOOL LoadToolBar(UINT nIDResource);

Paraméterek

lpszResourceName
Mutasson a betöltendő eszköztár erőforrásnevére.

nIDResource
A betöltendő eszköztár erőforrás-azonosítója.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Az eszköztár-erőforrás létrehozásával kapcsolatos további információkért tekintse meg az eszköztárszerkesztőt .

Example

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

CToolBar::SetBitmap

Hívja meg ezt a tagfüggvényt az eszköztár bitképének beállításához.

BOOL SetBitmap(HBITMAP hbmImageWell);

Paraméterek

hbmImageWell
Eszköztárhoz társított bitkép kezelése.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A bitlekép módosítására irányuló hívás SetBitmap például akkor történik, ha a felhasználó végrehajt egy műveletet egy olyan dokumentumon, amely módosítja egy gomb működését.

CToolBar::SetButtonInfo

Hívja meg ezt a tagfüggvényt a gomb parancsazonosítójának, stílusának és képszámának beállításához.

void SetButtonInfo(
    int nIndex,
    UINT nID,
    UINT nStyle,
    int iImage);

Paraméterek

nIndex
Annak a gombnak vagy elválasztónak a nullaalapú indexe, amelyhez az adatokat be kell állítani.

nID
Az az érték, amelyre a gomb parancsazonosítója be van állítva.

nStyle
Az új gombstílus. A következő gombstílusok támogatottak:

  • TBBS_BUTTON Standard nyomógomb (alapértelmezett)

  • TBBS_SEPARATOR Elválasztó

  • TBBS_CHECKBOX Automatikus jelölőnégyzet gomb

  • TBBS_GROUP Gombcsoport kezdetének megjelölése

  • TBBS_CHECKGROUP Bejelöli a jelölőnégyzetgombok egy csoportjának kezdetét

  • TBBS_DROPDOWN Legördülő lista gombot hoz létre.

  • TBBS_AUTOSIZE A gomb szélessége a gomb szövege alapján lesz kiszámítva, nem pedig a kép mérete alapján.

  • TBBS_NOPREFIX A gombszöveghez nem lesz hozzárendelve egy gyorsítóelőtag.

iImage
Új index a gomb képéhez a bitképen belül.

Megjegyzések

A stílust TBBS_SEPARATORtartalmazó elválasztók esetében ez a függvény képpontban állítja be az elválasztó szélességét a benne iImagetárolt értékre.

Megjegyzés:

A paraméterrel nStyle gombállapotokat is beállíthat, mivel azonban a gombállapotokat a ON_UPDATE_COMMAND_UI kezelő vezérli, a következő tétlen feldolgozás során a beállított SetButtonInfo állapotok elvesznek. További információt a User-Interface objektumok és a TN031: Vezérlősávok frissítése című témakörben talál.

A bitképképekről és a gombokról az Áttekintés és CToolBara CToolBar::LoadBitmap .

CToolBar::SetButtons

Ez a tagfüggvény az egyes eszköztárgombok parancsazonosítóját a tömb lpIDArraymegfelelő eleme által megadott értékre állítja.

BOOL SetButtons(
    const UINT* lpIDArray,
    int nIDCount);

Paraméterek

lpIDArray
Mutató a parancsazonosítók tömbje felé. Üres gombok lefoglalása null értékű lehet.

nIDCount
A tömb azon elemeinek száma, amelyek lpIDArraya következő szerint mutatnak: .

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ha a tömb egy eleme rendelkezik az értékkel ID_SEPARATOR, az eszköztár megfelelő helyén létrejön egy elválasztó. Ez a függvény beállítja az egyes gombok stílusát TBBS_BUTTON , és az egyes elválasztók stílusát TBBS_SEPARATORis, és minden egyes gombhoz hozzárendel egy képindexet. A képindex a gomb képének helyét adja meg a bitképen belül.

Nem kell figyelembe vennie a bitkép elválasztóit, mert ez a függvény nem rendel képindexeket az elválasztókhoz. Ha az eszköztáron a 0, 1 és 3 pozícióban lévő gombok, valamint a 2. pozícióban lévő elválasztó látható, akkor a bitkép 0, 1 és 2 pozíciójában lévő képek a 0, az 1 és a 3 pozícióban lévő gombokhoz vannak rendelve.

Null érték esetén lpIDArray ez a függvény helyet foglal le a megadott nIDCountszámú elemhez. Az egyes elemek attribútumainak beállítására használható SetButtonInfo .

CToolBar::SetButtonStyle

A tagfüggvény meghívásával beállíthatja egy gomb vagy elválasztó stílusát, vagy csoportosíthatja a gombokat.

void SetButtonStyle(
    int nIndex,
    UINT nStyle);

Paraméterek

nIndex
Annak a gombnak vagy elválasztónak az indexe, amelynek adatait be kell állítani.

nStyle
A gombstílus. A következő gombstílusok támogatottak:

  • TBBS_BUTTON Standard nyomógomb (alapértelmezett)

  • TBBS_SEPARATOR Elválasztó

  • TBBS_CHECKBOX Automatikus jelölőnégyzet gomb

  • TBBS_GROUP Gombcsoport kezdetének megjelölése

  • TBBS_CHECKGROUP Bejelöli a jelölőnégyzetgombok egy csoportjának kezdetét

  • TBBS_DROPDOWN Legördülő lista gomb létrehozása

  • TBBS_AUTOSIZE A gomb szélessége a gomb szövege alapján lesz kiszámítva, nem pedig a kép mérete alapján.

  • TBBS_NOPREFIX A gombszöveghez nem lesz hozzá társított gyorsítóelőtag

Megjegyzések

A gomb stílusa határozza meg, hogyan jelenik meg a gomb, és hogyan reagál a felhasználói bemenetre.

Hívás SetButtonStyleelőtt hívja meg a GetButtonStyle tagfüggvényt a gomb vagy az elválasztó stílus lekéréséhez.

Megjegyzés:

A paraméterrel nStyle gombállapotokat is beállíthat, mivel azonban a gombállapotokat a ON_UPDATE_COMMAND_UI kezelő vezérli, a következő tétlen feldolgozás során a beállított SetButtonStyle állapotok elvesznek. További információt a User-Interface objektumok és a TN031: Vezérlősávok frissítése című témakörben talál.

CToolBar::SetButtonText

A függvény meghívásával állítsa be a szöveget egy gombon.

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

Paraméterek

nIndex
Annak a gombnak az indexe, amelynek a szövegét be kell állítani.

lpszText
A gombon beállítani kívánt szövegre mutat.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Example

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

CToolBar::SetHeight

Ez a tagfüggvény az eszköztár magasságát a megadott képpontban megadott értékre állítja cyHeight.

void SetHeight(int cyHeight);

Paraméterek

cyHeight
Az eszköztár képpontban kifejezett magassága.

Megjegyzések

A hívás SetSizesután ezzel a tagfüggvénnyel felülbírálhatja a szokásos eszköztármagasságot. Ha a magasság túl kicsi, a gombok alul lesznek vágva.

Ha ezt a függvényt nem hívják meg, a keretrendszer a gomb méretével határozza meg az eszköztár magasságát.

CToolBar::SetSizes

Hívja meg ezt a tagfüggvényt, hogy az eszköztár gombjait képpontban sizeButtonmegadott méretre állítsa.

void SetSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Paraméterek

sizeButton
Az egyes gombok képpontban kifejezett mérete.

sizeImage
Az egyes képek képpontban kifejezett mérete.

Megjegyzések

A sizeImage paraméternek képpontban kell tartalmaznia az eszköztár bitképében lévő képek méretét. A befogható sizeButton méreteknek elegendőnek kell lenniük ahhoz, hogy a kép szélessége plusz 7 képpont plusz 6 képpont plusz magasság legyen. Ez a függvény az eszköztár magasságát is a gomboknak megfelelően állítja be.

Ezt a tagfüggvényt csak olyan eszköztárakhoz hívja meg, amelyek nem követik a windowsos felületre vonatkozó, gomb- és képméretekre vonatkozó szoftvertervezési ajánlásokat.

Example

// This code fragment is taken from CMainFrame::OnCreate
// CMainFrame is derived from CMDIFrameWnd

// This example shows how to add text to toolbar buttons.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_FLAT, WS_CHILD | WS_VISIBLE 
   | CBRS_TOP) || !m_wndToolBar.LoadToolBar(IDR_MAINFRAME))
{
   TRACE0("Failed to create toolbar\n");
   return -1;      // fail to create
}

//Show text on toolbar buttons.
VERIFY(m_wndToolBar.SetButtonText(0, _T("New")));
VERIFY(m_wndToolBar.SetButtonText(1, _T("Open")));
VERIFY(m_wndToolBar.SetButtonText(2, _T("Save")));
VERIFY(m_wndToolBar.SetButtonText(4, _T("Cut")));
VERIFY(m_wndToolBar.SetButtonText(5, _T("Copy")));
VERIFY(m_wndToolBar.SetButtonText(6, _T("Paste")));
VERIFY(m_wndToolBar.SetButtonText(8, _T("Print")));
VERIFY(m_wndToolBar.SetButtonText(9, _T("About")));

CRect temp;
m_wndToolBar.GetItemRect(0,&temp);
m_wndToolBar.SetSizes(CSize(temp.Width(),
   temp.Height()),CSize(16,15));

Lásd még

MFC-minta CTRLBARS
MFC-minta DLGCBR32
MFC-minta DOCKTOOL
CControlBar osztály
Hierarchiadiagram
CToolBarCtrl osztály

  • Last updated on