Sdílet prostřednictvím

CToolBarCtrl Třída

  • Článek

Poskytuje funkce běžného ovládacího prvku panelu nástrojů Windows.

Syntaxe

class CToolBarCtrl : public CWnd

Členové

Veřejné konstruktory

Název Popis
CToolBarCtrl::CToolBarCtrl CToolBarCtrl Vytvoří objekt.

Veřejné metody

Název Popis
CToolBarCtrl::AddBitmap Přidá jeden nebo více obrázků rastrových tlačítek do seznamu obrázků tlačítek, které jsou k dispozici pro ovládací prvek panelu nástrojů.
CToolBarCtrl::AddButtons Přidá jedno nebo více tlačítek do ovládacího prvku panelu nástrojů.
CToolBarCtrl::AddString Přidá do interního seznamu řetězců panelu nástrojů nový řetězec předaný jako ID prostředku.
CToolBarCtrl::AddStrings Přidá nový řetězec nebo řetězce, které jsou předány jako ukazatel do vyrovnávací paměti NULL-oddělených řetězců, do interního seznamu řetězců na panelu nástrojů.
CToolBarCtrl::AutoSize Změní velikost ovládacího prvku panelu nástrojů.
CToolBarCtrl::ChangeBitmap Změní rastrový obrázek tlačítka v aktuálním ovládacím prvku panelu nástrojů.
CToolBarCtrl::CheckButton Kontroluje nebo vymaže dané tlačítko v ovládacím prvku panelu nástrojů.
CToolBarCtrl::CommandToIndex Načte index založený na nule pro tlačítko přidružené k zadanému identifikátoru příkazu.
CToolBarCtrl::Create Vytvoří ovládací prvek panelu nástrojů a připojí ho k objektu CToolBarCtrl .
CToolBarCtrl::CreateEx Vytvoří ovládací prvek panelu nástrojů se zadanými rozšířenými styly Windows a připojí ho k objektu CToolBarCtrl .
CToolBarCtrl::Customize Zobrazí dialogové okno Přizpůsobit panel nástrojů.
CToolBarCtrl::DeleteButton Odstraní tlačítko z ovládacího prvku panelu nástrojů.
CToolBarCtrl::EnableButton Povolí nebo zakáže zadané tlačítko v ovládacím prvku panelu nástrojů.
CToolBarCtrl::GetAnchorHighlight Načte nastavení zvýraznění ukotvení panelu nástrojů.
CToolBarCtrl::GetBitmap Načte index rastrového obrázku přidruženého k tlačítku na panelu nástrojů.
CToolBarCtrl::GetBitmapFlags Získá příznaky přidružené k rastrový obrázek panelu nástrojů.
CToolBarCtrl::GetButton Načte informace o zadaném tlačítku v ovládacím prvku panelu nástrojů.
CToolBarCtrl::GetButtonCount Načte počet tlačítek aktuálně v ovládacím prvku panelu nástrojů.
CToolBarCtrl::GetButtonInfo Načte informace o tlačítku na panelu nástrojů.
CToolBarCtrl::GetButtonSize Načte aktuální šířku a výšku tlačítek panelu nástrojů v pixelech.
CToolBarCtrl::GetColorScheme Načte barevné schéma aktuálního ovládacího prvku panelu nástrojů.
CToolBarCtrl::GetDisabledImageList Načte seznam obrázků, který ovládací prvek panelu nástrojů používá k zobrazení zakázaných tlačítek.
CToolBarCtrl::GetDropTarget IDropTarget Načte rozhraní pro ovládací prvek panelu nástrojů.
CToolBarCtrl::GetExtendedStyle Načte rozšířené styly ovládacího prvku panelu nástrojů.
CToolBarCtrl::GetHotImageList Načte seznam obrázků, který ovládací prvek panelu nástrojů používá k zobrazení "horkých" tlačítek. Když je ukazatel myši nad ním, zobrazí se zvýrazněné horké tlačítko.
CToolBarCtrl::GetHotItem Načte index horké položky na panelu nástrojů.
CToolBarCtrl::GetImageList Načte seznam obrázků, který ovládací prvek panelu nástrojů používá k zobrazení tlačítek ve výchozím stavu.
CToolBarCtrl::GetInsertMark Načte aktuální značku vložení panelu nástrojů.
CToolBarCtrl::GetInsertMarkColor Načte barvu použitou k vykreslení značky vložení panelu nástrojů.
CToolBarCtrl::GetItemRect Načte ohraničující obdélník tlačítka v ovládacím prvku panelu nástrojů.
CToolBarCtrl::GetMaxSize Načte celkovou velikost všech viditelných tlačítek a oddělovačů na panelu nástrojů.
CToolBarCtrl::GetMaxTextRows Načte maximální počet textových řádků zobrazených na tlačítku panelu nástrojů.
CToolBarCtrl::GetMetrics Načte metriky ovládacího prvku panelu nástrojů.
CToolBarCtrl::GetPadding Načte vodorovné a svislé odsazení aktuálního ovládacího prvku panelu nástrojů.
CToolBarCtrl::GetPressedImageList Načte seznam obrázků, který aktuální ovládací prvek panelu nástrojů používá k reprezentaci tlačítek ve stisknutém stavu.
CToolBarCtrl::GetRect Načte ohraničující obdélník pro zadané tlačítko panelu nástrojů.
CToolBarCtrl::GetRows Načte počet řádků tlačítek aktuálně zobrazených na panelu nástrojů.
CToolBarCtrl::GetState Načte informace o stavu zadaného tlačítka v ovládacím prvku panelu nástrojů, například o tom, jestli je povolené, stisknuté nebo zaškrtnuté.
CToolBarCtrl::GetString Načte řetězec panelu nástrojů.
CToolBarCtrl::GetStyle Načte aktuálně používané styly pro ovládací prvek panelu nástrojů.
CToolBarCtrl::GetToolTips Načte popisovač ovládacího prvku popisku, pokud existuje, přidružený k ovládacímu prvku panelu nástrojů.
CToolBarCtrl::HideButton Skryje nebo zobrazí zadané tlačítko v ovládacím prvku panelu nástrojů.
CToolBarCtrl::HitTest Určuje, kde bod leží v ovládacím prvku panelu nástrojů.
CToolBarCtrl::Indeterminate Nastaví nebo vymaže neurčitý (šedý) stav zadaného tlačítka v ovládacím prvku panelu nástrojů.
CToolBarCtrl::InsertButton Vloží tlačítko do ovládacího prvku panelu nástrojů.
CToolBarCtrl::InsertMarkHitTest Načte informace o značce vložení pro bod na panelu nástrojů.
CToolBarCtrl::IsButtonChecked Určuje, zda je zadané tlačítko v ovládacím prvku panelu nástrojů zaškrtnuté.
CToolBarCtrl::IsButtonEnabled Určuje, jestli je zadané tlačítko v ovládacím prvku panelu nástrojů povolené.
CToolBarCtrl::IsButtonHidden Určuje, jestli je zadané tlačítko v ovládacím prvku panelu nástrojů skryté.
CToolBarCtrl::IsButtonHighlighted Zkontroluje stav zvýraznění tlačítka panelu nástrojů.
CToolBarCtrl::IsButtonIndeterminate Určuje, jestli je stav zadaného tlačítka v ovládacím prvku panelu nástrojů neurčitý (šedý).
CToolBarCtrl::IsButtonPressed Určuje, zda je zadané tlačítko v ovládacím prvku panelu nástrojů stisknuto.
CToolBarCtrl::LoadImages Načte rastrové obrázky do seznamu obrázků ovládacího prvku panelu nástrojů.
CToolBarCtrl::MapAccelerator Mapuje znak akcelerátoru na tlačítko panelu nástrojů.
CToolBarCtrl::MarkButton Nastaví stav zvýraznění daného tlačítka v ovládacím prvku panelu nástrojů.
CToolBarCtrl::MoveButton Přesune tlačítko z jednoho indexu do druhého.
CToolBarCtrl::PressButton Stiskne nebo uvolní zadané tlačítko v ovládacím prvku panelu nástrojů.
CToolBarCtrl::ReplaceBitmap Nahradí existující rastrový obrázek v aktuálním ovládacím prvku panelu nástrojů novým rastrovým obrázkem.
CToolBarCtrl::RestoreState Obnoví stav ovládacího prvku panelu nástrojů.
CToolBarCtrl::SaveState Uloží stav ovládacího prvku panelu nástrojů.
CToolBarCtrl::SetAnchorHighlight Nastaví nastavení zvýraznění ukotvení panelu nástrojů.
CToolBarCtrl::SetBitmapSize Nastaví velikost rastrových obrázků, které se mají přidat do ovládacího prvku panelu nástrojů.
CToolBarCtrl::SetButtonInfo Nastaví informace pro existující tlačítko na panelu nástrojů.
CToolBarCtrl::SetButtonSize Nastaví velikost tlačítek, která se mají přidat do ovládacího prvku panelu nástrojů.
CToolBarCtrl::SetButtonStructSize Určuje velikost TBBUTTON struktury.
CToolBarCtrl::SetButtonWidth Nastaví minimální a maximální šířku tlačítka v ovládacím prvku panelu nástrojů.
CToolBarCtrl::SetCmdID Nastaví identifikátor příkazu, který se má odeslat do okna vlastníka při stisknutí zadaného tlačítka.
CToolBarCtrl::SetColorScheme Nastaví barevné schéma aktuálního ovládacího prvku panelu nástrojů.
CToolBarCtrl::SetDisabledImageList Nastaví seznam obrázků, který bude ovládací prvek panelu nástrojů používat k zobrazení zakázaných tlačítek.
CToolBarCtrl::SetDrawTextFlags Nastaví příznaky ve funkci DrawTextWin32 , která se používá k vykreslení textu v zadaném obdélníku, formátované podle toho, jak jsou příznaky nastaveny.
CToolBarCtrl::SetExtendedStyle Nastaví rozšířené styly pro ovládací prvek panelu nástrojů.
CToolBarCtrl::SetHotImageList Nastaví seznam obrázků, který bude ovládací prvek panelu nástrojů používat k zobrazení "horkých" tlačítek.
CToolBarCtrl::SetHotItem Nastaví horkou položku na panelu nástrojů.
CToolBarCtrl::SetImageList Nastaví seznam obrázků, který bude panel nástrojů používat k zobrazení tlačítek, která jsou ve výchozím stavu.
CToolBarCtrl::SetIndent Nastaví odsazení prvního tlačítka v ovládacím prvku panelu nástrojů.
CToolBarCtrl::SetInsertMark Nastaví aktuální značku vložení panelu nástrojů.
CToolBarCtrl::SetInsertMarkColor Nastaví barvu použitou k vykreslení značky vložení panelu nástrojů.
CToolBarCtrl::SetMaxTextRows Nastaví maximální počet textových řádků zobrazených na tlačítku panelu nástrojů.
CToolBarCtrl::SetMetrics Nastaví metriky ovládacího prvku panelu nástrojů.
CToolBarCtrl::SetOwner Nastaví okno pro příjem zpráv oznámení z ovládacího prvku panelu nástrojů.
CToolBarCtrl::SetPadding Nastaví vodorovné a svislé odsazení aktuálního ovládacího prvku panelu nástrojů.
CToolBarCtrl::SetPressedImageList Nastaví seznam obrázků, který aktuální ovládací prvek panelu nástrojů používá k reprezentaci tlačítek v stisknutém stavu.
CToolBarCtrl::SetRows Nastaví počet řádků tlačítek zobrazených na panelu nástrojů.
CToolBarCtrl::SetState Nastaví stav zadaného tlačítka v ovládacím prvku panelu nástrojů.
CToolBarCtrl::SetStyle Nastaví styly ovládacího prvku panelu nástrojů.
CToolBarCtrl::SetToolTips Přidruží ovládací prvek popisku nástroje k ovládacímu prvku panelu nástrojů.
CToolBarCtrl::SetWindowTheme Nastaví vizuální styl ovládacího prvku panelu nástrojů.

Poznámky

Tento ovládací prvek (a proto CToolBarCtrl třída) je k dispozici pouze pro programy spuštěné v systémech Windows 95/98 a systém Windows NT verze 3.51 a novější.

Běžný ovládací prvek panelu nástrojů Windows je obdélníkové podřízené okno, které obsahuje jedno nebo více tlačítek. Tato tlačítka můžou zobrazit rastrový obrázek, řetězec nebo obojí. Když uživatel vybere tlačítko, odešle příkazovou zprávu do okna vlastníka panelu nástrojů. Tlačítka na panelu nástrojů obvykle odpovídají položkám v nabídce aplikace; poskytují uživatelům přímojší způsob přístupu k příkazům aplikace.

CToolBarCtrl objekty obsahují několik důležitých interních datových struktur: seznam rastrových obrázků tlačítek nebo seznam obrázků, seznam řetězců popisků tlačítek a seznam TBBUTTON struktur, které přidružují obrázek a/nebo řetězec k pozici, stylu, stavu a ID příkazu tlačítka. Každý z prvků těchto datových struktur se označuje indexem založeným na nule. Než budete moct objekt použít CToolBarCtrl , musíte nastavit tyto datové struktury. Seznam řetězců lze použít pouze pro popisky tlačítek; z panelu nástrojů nemůžete načíst řetězce.

Pokud chcete použít CToolBarCtrl objekt, obvykle postupujte takto:

  1. CToolBarCtrl Vytvořte objekt.

  2. Volání Create pro vytvoření běžného ovládacího prvku panelu nástrojů Systému Windows a jeho připojení k objektu CToolBarCtrl Označte styl panelu nástrojů pomocí stylů, například TBSTYLE_TRANSPARENT průhledného panelu nástrojů nebo TBSTYLE_DROPDOWN panelu nástrojů, který podporuje tlačítka rozevíracího seznamu stylů.

  3. Určete, jak se mají tlačítka na panelu nástrojů zobrazovat:

    • Chcete-li použít rastrové obrázky pro tlačítka, přidejte rastrové obrázky tlačítka na panel nástrojů voláním AddBitmap.

    • Chcete-li použít obrázky zobrazené ze seznamu obrázků pro tlačítka, zadejte seznam obrázků voláním SetImageList, SetHotImageListnebo SetDisabledImageList.

    • Chcete-li použít popisky řetězců pro tlačítka, přidejte řetězce na panel nástrojů voláním AddString a/nebo AddStrings.

  4. Přidání struktur tlačítek na panel nástrojů voláním AddButtons.

  5. Pokud chcete, aby se v okně vlastníka zobrazovaly tipy pro panel nástrojů, které nejsou CFrameWnd, musíte zpracovávat TTN_NEEDTEXT zprávy v okně vlastníka panelu nástrojů, jak je popsáno v oznámeních popisů popisů tlačítek. Pokud je nadřazené okno panelu nástrojů odvozeno z CFrameWnd, zobrazí se popisy nástrojů bez dalšího úsilí, protože CFrameWnd poskytuje výchozí obslužnou rutinu.

  6. Pokud chcete, aby váš uživatel mohl přizpůsobit panel nástrojů, zpracujte zprávy oznámení o přizpůsobení v okně vlastníka, jak je popsáno v části Zpracování oznámení přizpůsobení.

Můžete použít SaveState k uložení aktuálního stavu ovládacího prvku panelu nástrojů v registru a RestoreState k obnovení stavu na základě informací dříve uložených v registru. Kromě uložení stavu panelu nástrojů mezi použitím aplikace aplikace obvykle ukládají stav před tím, než uživatel začne přizpůsobovat panel nástrojů v případě, že uživatel později chce obnovit panel nástrojů do původního stavu.

Podpora aplikace Internet Explorer verze 4.0 a novější

Pro podporu funkcí zavedených v Aplikaci Internet Explorer verze 4.0 a novější poskytuje mfc podporu seznamu obrázků a průhledné a ploché styly pro ovládací prvky panelu nástrojů.

Průhledný panel nástrojů umožňuje klientovi na panelu nástrojů zobrazit. Pokud chcete vytvořit průhledný panel nástrojů, použijte oba TBSTYLE_FLAT styly.TBSTYLE_TRANSPARENT Průhledné panely nástrojů mají aktivní sledování; to znamená, že když se ukazatel myši přesune přes horké tlačítko na panelu nástrojů, vzhled tlačítka se změní. Panely nástrojů vytvořené pouze pomocí TBSTYLE_FLAT stylu budou obsahovat tlačítka, která nejsou průhledná.

Podpora seznamu obrázků umožňuje větší flexibilitu ovládacího prvku pro výchozí chování, horké obrázky a zakázané obrázky. Pomocí GetImageLista GetHotImageListGetDisabledImageList s průhledným panelem nástrojů můžete manipulovat s obrázkem podle jeho stavu:

Další informace o použití CToolBarCtrlnaleznete v tématu Ovládací prvky a použití CToolBarCtrl.

Hierarchie dědičnosti

CObject

CCmdTarget

CWnd

CToolBarCtrl

Požadavky

Záhlaví: afxcmn.h

CToolBarCtrl::AddBitmap

Přidá jeden nebo více obrázků tlačítek do seznamu obrázků tlačítek uložených v ovládacím prvku panelu nástrojů.

int AddBitmap(
    int nNumButtons,
    UINT nBitmapID);

int AddBitmap(
    int nNumButtons,
    CBitmap* pBitmap);

Parametry

nNumButtons
Počet obrázků tlačítek v rastrovém obrázku

nBitmapID
Identifikátor prostředku rastrového obrázku, který obsahuje obrázek tlačítka nebo obrázky, které chcete přidat.

pBitmap
Ukazatel na CBitmap objekt, který obsahuje obrázek tlačítka nebo obrázky, které chcete přidat.

Návratová hodnota

Index založený na nule prvního nového obrázku v případě úspěchu; jinak - 1.

Poznámky

Před přidáním rastrového obrázku na panel nástrojů můžete pomocí rozhraní API CreateMappedBitmap systému Windows mapovat barvy. Pokud předáte ukazatel na CBitMap objekt, musíte zajistit, aby rastrový obrázek nebyl zničen až po zničení panelu nástrojů.

CToolBarCtrl::AddButtons

Přidá jedno nebo více tlačítek do ovládacího prvku panelu nástrojů.

BOOL AddButtons(
    int nNumButtons,
    LPTBBUTTON lpButtons);

Parametry

nNumButtons
Počet tlačítek, která chcete přidat

lpButtons
Adresa pole TBBUTTON struktur obsahujících informace o tlačítkách, která se mají přidat. V poli musí být stejný počet prvků jako tlačítka určená nNumButtonspomocí .

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Ukazatel lpButtons odkazuje na pole TBBUTTON struktur. Každá TBBUTTON struktura přidruží přidané tlačítko ke stylu tlačítka, obrázku nebo řetězci, ID příkazu, stavu a uživatelsky definovaným datům:

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;

Členové jsou následující:

  • iBitmap

    Index tlačítka založený na nule, -1, pokud není k tomuto tlačítku žádný.

  • idCommand

    Identifikátor příkazu přidružený k tlačítku. Tento identifikátor se odešle ve WM_COMMAND zprávě při výběru tlačítka. fsStyle Pokud má TBSTYLE_SEP člen hodnotu, musí být tento člen nulový.

  • fsState

    Příznaky stavu tlačítka. Může se jednat o kombinaci níže uvedených hodnot:

    • TBSTATE_CHECKED Tlačítko má TBSTYLE_CHECKED styl a stisknete ho.

    • TBSTATE_ENABLED Tlačítko přijímá uživatelský vstup. Tlačítko, které nemá tento stav, nepřijímá vstup uživatele a je šedé.

    • TBSTATE_HIDDEN Tlačítko není viditelné a nemůže přijímat vstup uživatele.

    • TBSTATE_INDETERMINATE Tlačítko je šedé.

    • TBSTATE_PRESSED Tlačítko se stiskne.

    • TBSTATE_WRAP Za tlačítkem následuje konec řádku. Tlačítko musí mít TBSTATE_ENABLED také stav.

  • fsStyle

    Styl tlačítka Může se jednat o kombinaci níže uvedených hodnot:

    • TBSTYLE_BUTTON Vytvoří standardní tlačítko.

    • TBSTYLE_CHECK Vytvoří tlačítko, které se přepne mezi stisknutými a nestisknutými stavy pokaždé, když na něj uživatel klikne. Tlačítko má jinou barvu pozadí, když je v stisknutém stavu.

    • TBSTYLE_CHECKGROUP Vytvoří tlačítko zaškrtnutí, které zůstane stisknuté, dokud se nestiskne jiné tlačítko ve skupině.

    • TBSTYLE_GROUP Vytvoří tlačítko, které zůstane stisknuté, dokud se nestiskne jiné tlačítko ve skupině.

    • TBSTYLE_SEP Vytvoří oddělovač, který poskytuje malou mezeru mezi skupinami tlačítek. Tlačítko s tímto stylem nepřijímá uživatelský vstup.

  • dwData

    Uživatelsky definovaná data.

  • iString

    Index řetězce založený na nule, který se má použít jako popisek tlačítka , -1, pokud pro toto tlačítko neexistuje žádný řetězec.

Obrázek nebo řetězec, jehož index, který zadáte, byl dříve přidán do seznamu ovládacího prvku panelu nástrojů pomocí , AddBitmapAddStringa/nebo AddStrings.

CToolBarCtrl::AddString

Přidá do interního seznamu řetězců panelu nástrojů nový řetězec předaný jako ID prostředku.

int AddString(UINT nStringID);

Parametry

nStringID
Identifikátor prostředku řetězce, který chcete přidat do seznamu řetězců ovládacího prvku panelu nástrojů.

Návratová hodnota

Index založený na nule prvního nového řetězce přidaný v případě úspěchu; jinak -1.

CToolBarCtrl::AddStrings

Přidá nový řetězec nebo řetězce do seznamu řetězců dostupných pro ovládací prvek panelu nástrojů.

int AddStrings(LPCTSTR lpszStrings);

Parametry

lpszStrings
Adresa vyrovnávací paměti, která obsahuje jeden nebo více NULLřetězců ukončených pro přidání do seznamu řetězců panelu nástrojů. Poslední řetězec musí být ukončen dvěma NULL znaky.

Návratová hodnota

Index založený na nule prvního nového řetězce přidaný v případě úspěchu; jinak -1.

Poznámky

Řetězce v vyrovnávací paměti musí být oddělené znakem NULL . Musíte zajistit, aby poslední řetězec měl dva NULL ukončovací znaky. Pokud chcete správně naformátovat konstantní řetězec, můžete ho napsat takto:

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

nebo:

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

Do této funkce byste neměli předávat CString objekt, protože není možné mít více než jeden NULL znak v objektu CString.

CToolBarCtrl::AutoSize

Změní velikost celého ovládacího prvku panelu nástrojů.

void AutoSize();

Poznámky

Tuto funkci byste měli volat, když se změní velikost nadřazeného okna nebo když se změní velikost panelu nástrojů (například při nastavení tlačítka nebo velikosti rastrového obrázku nebo přidání řetězců).

CToolBarCtrl::ChangeBitmap

Změní rastrový obrázek tlačítka v aktuálním ovládacím prvku panelu nástrojů.

BOOL ChangeBitmap(
    int idButton,
    int iBitmap);

Parametry

idButton
[v] Identifikátor příkazu tlačítka, který má dostat nový rastrový obrázek.

iBitmap
[v] Index obrázku založený na nule v seznamu obrázků aktuálního ovládacího prvku panelu nástrojů

Návratová hodnota

TRUEpokud je tato metoda úspěšná; v opačném případě . FALSE

Poznámky

Pokud je tato metoda úspěšná, systém zobrazí zadaný obrázek v zadaném tlačítku.

Tato metoda odešle TB_CHANGEBITMAP zprávu popsanou v sadě Windows SDK.

Příklad

Následující příklad kódu změní rastrový obrázek pro tlačítko Uložit soubor na bitmapu pro tlačítko O aplikaci.

{
   // 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

Kontroluje nebo vymaže dané tlačítko v ovládacím prvku panelu nástrojů.

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

Parametry

nID
Identifikátor příkazu tlačítka, který chcete zkontrolovat nebo zrušit.

bCheck
TRUE pokud chcete tlačítko zkontrolovat, FALSE vymažte ho.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Když je tlačítko zaškrtnuté, zdá se, že bylo stisknuto. Pokud chcete změnit více než jeden stav tlačítka, zvažte místo toho volání SetState .

CToolBarCtrl::CommandToIndex

Načte index založený na nule pro tlačítko přidružené k zadanému identifikátoru příkazu.

UINT CommandToIndex(UINT nID) const;

Parametry

nID
ID příkazu, jehož index tlačítka chcete najít.

Návratová hodnota

Index založený na nule tlačítka přidruženého k ID příkazu.

Poznámky

CToolBarCtrl::Create

Vytvoří ovládací prvek panelu nástrojů a připojí ho k objektu CToolBarCtrl .

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

Parametry

dwStyle
Určuje styl ovládacího prvku panelu nástrojů. Panely nástrojů musí mít vždy WS_CHILD styl. Kromě toho můžete určit libovolnou kombinaci stylů panelu nástrojů a stylů oken, jak je popsáno v části Poznámky.

rect
Volitelně můžete určit velikost a umístění ovládacího prvku panelu nástrojů. Může to být CRect objekt nebo RECT struktura.

pParentWnd
Určuje nadřazené okno ovládacího prvku panelu nástrojů. Nesmí to být NULL.

nID
Určuje ID ovládacího prvku panelu nástrojů.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Sestavíte ho CToolBarCtrl ve dvou krocích. Nejprve zavolejte konstruktor a potom volání Create, který vytvoří ovládací prvek panelu nástrojů a připojí ho k objektu CToolBarCtrl . U ovládacího prvku panelu nástrojů použijte následující styly oken.

  • WS_CHILD Vždy

  • WS_VISIBLE Obvykle

  • WS_DISABLED Zřídka

Popis CreateWindow stylů oken najdete v sadě Windows SDK.

Volitelně můžete použít kombinaci běžných stylů ovládacích prvků, jak je popsáno v sadě Windows SDK.

Použití kombinace stylů panelu nástrojů u samotného ovládacího prvku nebo tlačítek Styly jsou popsány v tématu Panel nástrojů ovládací prvek a styly tlačítek v sadě Windows SDK.

Chcete-li použít rozšířené styly panelu nástrojů, zavolejte SetExtendedStyle po volání Create. Chcete-li vytvořit panel nástrojů s rozšířenými styly oken, místo volání CToolBarCtrl::CreateEx Create.

Ovládací prvek panelu nástrojů automaticky nastaví velikost a umístění okna panelu nástrojů. Výška je založená na výšce tlačítek na panelu nástrojů. Šířka je stejná jako šířka klientské oblasti nadřazeného okna. Styly CCS_TOP určují CCS_BOTTOM , zda je panel nástrojů umístěn podél horní nebo dolní části klientské oblasti. Ve výchozím nastavení má CCS_TOP panel nástrojů styl.

CToolBarCtrl::CreateEx

Vytvoří ovládací prvek (podřízené okno) a přidruží ho k objektu CToolBarCtrl .

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

Parametry

dwExStyle
Určuje rozšířený styl vytvářeného ovládacího prvku. Seznam rozšířených stylů Windows najdete v parametru dwExStyle sady CreateWindowEx Windows SDK.

dwStyle
Určuje styl ovládacího prvku panelu nástrojů. Panely nástrojů musí mít vždy WS_CHILD styl. Kromě toho můžete určit libovolnou kombinaci stylů panelu nástrojů a stylů oken, jak je popsáno v části Poznámky oddílu Create.

rect
Odkaz na RECT strukturu popisující velikost a umístění okna, které se má vytvořit, v souřadnicích pParentWndklienta .

pParentWnd
Ukazatel na okno, které je nadřazeným objektem ovládacího prvku.

nID
ID podřízeného okna ovládacího prvku.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Create Místo CreateEx použití rozšířených stylů Windows určených předmětu WS_EX_rozšířeného stylu Windows . CreateEx vytvoří ovládací prvek s rozšířenými styly Windows určenými dwExStyle. Nastavte rozšířené styly specifické pro ovládací prvek pomocí SetExtendedStyle. Slouží CreateEx například k nastavení takových stylů, jako WS_EX_CONTEXTHELPje , ale slouží SetExtendedStyle k nastavení takových stylů jako TBSTYLE_EX_DRAWDDARROWS. Další informace naleznete v části Styly popsané v panelu nástrojů Rozšířené styly v sadě Windows SDK.

CToolBarCtrl::CToolBarCtrl

CToolBarCtrl Vytvoří objekt.

CToolBarCtrl();

Poznámky

Musíte zavolat Create , aby byl panel nástrojů použitelný.

CToolBarCtrl::Customize

Zobrazí dialogové okno Přizpůsobit panel nástrojů.

void Customize();

Poznámky

Toto dialogové okno umožňuje uživateli přizpůsobit panel nástrojů přidáním a odstraněním tlačítek. Pokud chcete podporovat přizpůsobení, nadřazené okno panelu nástrojů musí zpracovávat zprávy oznámení o přizpůsobení, jak je popsáno v části Zpracování oznámení o přizpůsobení. Panel nástrojů musí být vytvořen také pomocí CCS_ADJUSTABLE stylu, jak je popsáno v tématu CToolBarCtrl::Create.

CToolBarCtrl::DeleteButton

Odstraní tlačítko z ovládacího prvku panelu nástrojů.

BOOL DeleteButton(int nIndex);

Parametry

nIndex
Index tlačítka založený na nule, který chcete odstranit.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

CToolBarCtrl::EnableButton

Povolí nebo zakáže zadané tlačítko v ovládacím prvku panelu nástrojů.

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

Parametry

nID
Identifikátor příkazu tlačítka, který chcete povolit nebo zakázat.

bEnable
TRUE pro povolení tlačítka; FALSE tlačítko zakážete.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Když je tlačítko povolené, můžete ho stisknout a zkontrolovat. Pokud chcete změnit více než jeden stav tlačítka, zvažte místo toho volání SetState .

CToolBarCtrl::GetAnchorHighlight

Načte nastavení zvýraznění ukotvení panelu nástrojů.

BOOL GetAnchorHighlight() const;

Návratová hodnota

Pokud není nula, zvýraznění ukotvení je povolené. Pokud je nula, zvýraznění ukotvení je zakázané.

Poznámky

Tato členová funkce implementuje chování zprávy TB_GETANCHORHIGHLIGHTWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::GetBitmap

Načte index rastrového obrázku přidruženého k tlačítku na panelu nástrojů.

int GetBitmap(int nID) const;

Parametry

nID
Identifikátor příkazu tlačítka, jehož rastrový index se má načíst.

Návratová hodnota

Vrátí index rastrového obrázku, pokud je úspěšný, nebo nula jinak.

Poznámky

Implementuje funkce TB_GETBITMAP v sadě Windows SDK.

CToolBarCtrl::GetBitmapFlags

Načte rastrové příznaky z panelu nástrojů.

UINT GetBitmapFlags() const;

Návratová hodnota

A UINT , která má TBBF_LARGE nastavený příznak, pokud zobrazení může podporovat velké rastrové obrázky panelu nástrojů, v opačném případě zrušte zaškrtnutí.

Poznámky

Měli byste ho zavolat po vytvoření panelu nástrojů, ale před přidáním rastrových obrázků na panel nástrojů. Vrácená hodnota označuje, zda zobrazení podporuje velké rastrové obrázky, nebo ne. Pokud zobrazení podporuje velké rastrové obrázky a pokud se rozhodnete je použít, zavolejte SetBitmapSize a SetButtonSize před přidáním velké bitmapy pomocí AddBitmap.

CToolBarCtrl::GetButton

Načte informace o zadaném tlačítku v ovládacím prvku panelu nástrojů.

BOOL GetButton(
    int nIndex,
    LPTBBUTTON lpButton) const;

Parametry

nIndex
Index tlačítka založený na nule, pro které chcete načíst informace.

lpButton
TBBUTTON Adresa struktury, která má dostat kopii informací o tlačítku. Informace CToolBarCtrl::AddButtons o struktuře TBBUTTON najdete v tématu.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

CToolBarCtrl::GetButtonCount

Načte počet tlačítek aktuálně v ovládacím prvku panelu nástrojů.

int GetButtonCount() const;

Návratová hodnota

Počet tlačítek.

CToolBarCtrl::GetButtonInfo

Načte informace o tlačítku na panelu nástrojů.

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

Parametry

nID
Identifikátor tlačítka.

ptbbi
Ukazatel na TBBUTTONINFO strukturu, která přijímá informace o tlačítku.

Návratová hodnota

Index tlačítka založený na nule, pokud je úspěšný; jinak -1.

Poznámky

Tato členová funkce implementuje chování zprávy TB_GETBUTTONINFOWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::GetButtonSize

Získá velikost tlačítka panelu nástrojů.

DWORD GetButtonSize() const;

Návratová hodnota

Hodnota DWORD , která obsahuje hodnoty šířky a výšky v LOWORD a HIWORDv uvedeném pořadí.

CToolBarCtrl::GetButtonText

Načte zobrazovaný text zadaného tlačítka na aktuálním ovládacím prvku panelu nástrojů.

CString GetButtonText(int idButton) const;

Parametry

idButton
[v] Identifikátor tlačítka, jehož zobrazovaný text se načte.

Návratová hodnota

A CString obsahující zobrazovaný text zadaného tlačítka.

Poznámky

Tato metoda odešle TB_GETBUTTONTEXT zprávu popsanou v sadě Windows SDK.

CToolBarCtrl::GetColorScheme

Načte barevné schéma aktuálního ovládacího prvku panelu nástrojů.

BOOL GetColorScheme(COLORSCHEME* lpColorScheme) const;

Parametry

lpColorScheme
[ven] Ukazatel na COLORSCHEME strukturu, která přijímá informace o barevném schématu. Když tato metoda vrátí, struktura popisuje barvu zvýraznění a barvu stínu ovládacího prvku panelu nástrojů.

Návratová hodnota

TRUEpokud je tato metoda úspěšná; v opačném případě . FALSE

Poznámky

Tato metoda odešle TB_GETCOLORSCHEME zprávu popsanou v sadě Windows SDK.

CToolBarCtrl::GetDisabledImageList

Načte seznam obrázků, který ovládací prvek panelu nástrojů používá k zobrazení zakázaných tlačítek.

CImageList* GetDisabledImageList() const;

Návratová hodnota

Ukazatel na CImageList objekt nebo NULL pokud není nastavený žádný zakázaný seznam obrázků.

Poznámky

Tato členová funkce implementuje chování zprávy TB_GETDISABLEDIMAGELISTWin32, jak je popsáno v sadě Windows SDK. Implementace GetDisabledImageList MFC používá CImageList objekt obsahující obrázky tlačítek ovládacího prvku panelu nástrojů, nikoli popisovač seznamu obrázků.

CToolBarCtrl::GetDropTarget

IDropTarget Načte rozhraní pro ovládací prvek panelu nástrojů.

HRESULT GetDropTarget(IDropTarget** ppDropTarget) const;

Parametry

ppDropTarget
Ukazatel na IDropTarget ukazatel rozhraní. Pokud dojde k chybě, NULL umístí se do této adresy ukazatel.

Návratová hodnota

Vrátí hodnotu označující HRESULT úspěch nebo selhání operace.

Poznámky

Tato členová funkce implementuje chování zprávy TB_GETOBJECTWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::GetExtendedStyle

Načte rozšířené styly ovládacího prvku panelu nástrojů.

DWORD GetExtendedStyle() const;

Návratová hodnota

A DWORD , který představuje rozšířené styly aktuálně používané pro ovládací prvek panelu nástrojů. Seznam stylů naleznete v části Panel nástrojů Rozšířené styly v sadě Windows SDK.

Poznámky

Tato členová funkce implementuje chování zprávy TB_GETEXTENDEDSTYLEWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::GetHotImageList

Načte seznam obrázků, který ovládací prvek panelu nástrojů používá k zobrazení "horkých" tlačítek. Když je ukazatel myši nad ním, zobrazí se zvýrazněné horké tlačítko.

CImageList* GetHotImageList() const;

Návratová hodnota

Ukazatel na CImageList objekt nebo NULL pokud není nastavený žádný zakázaný seznam obrázků.

Poznámky

Tato členová funkce implementuje chování zprávy TB_GETHOTIMAGELISTWin32, jak je popsáno v sadě Windows SDK. Když je ukazatel myši nad ním, zobrazí se zvýrazněné horké tlačítko.

CToolBarCtrl::GetHotItem

Načte index horké položky na panelu nástrojů.

int GetHotItem() const;

Návratová hodnota

Index horké položky na panelu nástrojů založený na nule.

Poznámky

Tato členová funkce implementuje chování zprávy TB_GETHOTITEMWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::GetImageList

Načte seznam obrázků, který ovládací prvek panelu nástrojů používá k zobrazení tlačítek ve výchozím stavu.

CImageList* GetImageList() const;

Návratová hodnota

Ukazatel na CImageList objekt nebo NULL pokud není nastavený žádný seznam obrázků.

Poznámky

Tato členová funkce implementuje chování zprávy TB_GETIMAGELISTWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::GetInsertMark

Načte aktuální značku vložení panelu nástrojů.

void GetInsertMark(TBINSERTMARK* ptbim) const;

Parametry

ptbim
Ukazatel na TBINSERTMARK strukturu, která obdrží značku vložení.

Poznámky

Tato členová funkce implementuje chování zprávy TB_GETINSERTMARKWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::GetInsertMarkColor

Načte barvu použitou k vykreslení značky vložení panelu nástrojů.

COLORREF GetInsertMarkColor() const;

Návratová hodnota

Hodnota COLORREF , která obsahuje aktuální barvu značky vložení.

Poznámky

Tato členová funkce implementuje chování zprávy TB_GETINSERTMARKCOLORWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::GetItemRect

Načte ohraničující obdélník tlačítka v ovládacím prvku panelu nástrojů.

BOOL GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parametry

nIndex
Index tlačítka založený na nule, pro které chcete načíst informace.

lpRect
Adresa struktury nebo objektu RECT CRect , který přijímá souřadnice ohraničujícího obdélníku.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Tato funkce nenačte ohraničující obdélník pro tlačítka, jejichž stav je nastavený na TBSTATE_HIDDEN.

CToolBarCtrl::GetMaxSize

Načte celkovou velikost všech viditelných tlačítek a oddělovačů na panelu nástrojů.

BOOL GetMaxSize(LPSIZE pSize) const;

Parametry

pSize
Ukazatel na SIZE strukturu, která přijímá velikost položek.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Tato členová funkce implementuje chování zprávy TB_GETMAXSIZEWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::GetMaxTextRows

Načte maximální počet textových řádků zobrazených na tlačítku panelu nástrojů.

int GetMaxTextRows() const;

Návratová hodnota

Maximální počet řádků textu zobrazených na tlačítku panelu nástrojů

CToolBarCtrl::GetMetrics

Načte metriky objektu CToolBarCtrl .

void GetMetrics(LPTBMETRICS ptbm) const;

Parametry

ptbm
Ukazatel na TBMETRICS strukturu objektu CToolBarCtrl .

Poznámky

Tato členová funkce emuluje funkce TB_GETMETRICS zprávy, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::GetPadding

Načte vodorovné a svislé odsazení aktuálního ovládacího prvku panelu nástrojů.

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

Parametry

pnHorzPadding
[ven] Celé číslo, které přijímá vodorovné odsazení ovládacího prvku panelu nástrojů v pixelech.

pnVertPadding
[ven] Celé číslo, které obdrží svislé odsazení ovládacího prvku panelu nástrojů v pixelech.

Návratová hodnota

TRUEpokud je tato metoda úspěšná; v opačném případě . FALSE

Poznámky

Tato metoda odešle TB_GETPADDING zprávu popsanou v sadě Windows SDK.

CToolBarCtrl::GetPressedImageList

Načte seznam obrázků, který aktuální ovládací prvek panelu nástrojů používá k reprezentaci tlačítek ve stisknutém stavu.

CImageList* GetPressedImageList();

Návratová hodnota

Ukazatel myši na CImageList seznam obrázků pro aktuální ovládací prvek nebo NULL pokud není nastavený žádný takový seznam obrázků.

Poznámky

Tato metoda odešle TB_GETPRESSEDIMAGELIST zprávu popsanou v sadě Windows SDK.

CToolBarCtrl::GetRect

Načte ohraničující obdélník pro zadané tlačítko panelu nástrojů.

BOOL GetRect(
    int nID,
    LPRECT lpRect) const;

Parametry

nID
Identifikátor tlačítka.

lpRect
Ukazatel na RECT strukturu pro příjem informací o ohraničující obdélník.

Návratová hodnota

TRUE v případě úspěchu; jinak FALSE.

Poznámky

Tato členová funkce implementuje chování zprávy TB_GETRECTWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::GetRows

Načte počet řádků tlačítek aktuálně zobrazených ovládacím panelem nástrojů.

int GetRows() const;

Návratová hodnota

Počet řádků tlačítek aktuálně zobrazených na panelu nástrojů

Poznámky

Všimněte si, že počet řádků bude vždy jeden, pokud nebyl vytvořen panel nástrojů se stylem TBSTYLE_WRAPABLE .

CToolBarCtrl::GetState

Načte informace o stavu zadaného tlačítka v ovládacím prvku panelu nástrojů, například o tom, jestli je povolené, stisknuté nebo zaškrtnuté.

int GetState(int nID) const;

Parametry

nID
Identifikátor příkazu tlačítka, pro které chcete načíst informace.

Návratová hodnota

Informace o stavu tlačítka v případě úspěchu nebo -1 v opačném případě. Informace o stavu tlačítka mohou být kombinací hodnot uvedených v CToolBarCtrl::AddButtons.

Poznámky

Tato funkce je zvlášť praktická, pokud chcete načíst více stavů tlačítek. Chcete-li pouze načíst jeden stav, použijte jednu z následujících členských funkcí: IsButtonEnabled, IsButtonChecked, IsButtonPressed, IsButtonHidden, nebo IsButtonIndeterminate. GetState Členské funkce je ale jediným způsobem, jak zjistit TBSTATE_WRAP stav tlačítka.

CToolBarCtrl::GetString

Načte řetězec panelu nástrojů.

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

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

Parametry

nString
Index řetězce

lpstrString
Ukazatel na vyrovnávací paměť použitou k vrácení řetězce.

cchMaxLen
Délka vyrovnávací paměti v bajtech.

str
Řetězec

Návratová hodnota

Délka řetězce, pokud je úspěšná, -1, pokud ne.

Poznámky

Tato členová funkce implementuje chování zprávy TB_GETSTRINGWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::GetStyle

Získá styly aktuálně použité pro ovládací prvek panelu nástrojů.

DWORD GetStyle() const;

Návratová hodnota

Obsahuje DWORD kombinaci stylů ovládacích prvků panelu nástrojů, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::GetToolTips

Načte popisovač ovládacího prvku popisku, pokud existuje, přidružený k ovládacímu prvku panelu nástrojů.

CToolTipCtrl* GetToolTips() const;

Návratová hodnota

Ukazatel na objekt přidružený k CToolTipCtrl tomuto panelu nástrojů nebo NULL pokud panel nástrojů nemá přidružený ovládací prvek popisku.

Poznámky

Vzhledem k tomu, že ovládací prvek panelu nástrojů obvykle vytváří a udržuje vlastní ovládací prvek popisku nástroje, většina programů tuto funkci nemusí volat.

CToolBarCtrl::HitTest

Určuje, kde bod leží v ovládacím prvku panelu nástrojů.

int HitTest(LPPOINT ppt) const;

Parametry

ppt
Ukazatel na POINT strukturu, která obsahuje souřadnici x testu hitu ve členu x a souřadnici y testu hitu ve členu y . Souřadnice jsou relativní vzhledem k klientské oblasti panelu nástrojů.

Návratová hodnota

Celočíselná hodnota označující umístění bodu na panelu nástrojů. Pokud je hodnota nula nebo kladná hodnota, je tato návratová hodnota indexem založeným na nule položky, ve které bod leží.

Pokud je vrácená hodnota záporná, bod neleží na tlačítku. Absolutní hodnota návratové hodnoty je index položky oddělovače nebo nejbližší neseparátorové položky.

Poznámky

Tato členová funkce implementuje chování zprávy TB_HITTESTWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::HideButton

Skryje nebo zobrazí zadané tlačítko v ovládacím prvku panelu nástrojů.

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

Parametry

nID
Identifikátor příkazu tlačítka, který chcete skrýt nebo zobrazit.

bHide
TRUE tlačítko skryjete, FALSE aby se zobrazilo.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Pokud chcete změnit více než jeden stav tlačítka, zvažte místo toho volání SetState .

CToolBarCtrl::Indeterminate

Nastaví nebo vymaže neurčitý stav zadaného tlačítka v ovládacím prvku panelu nástrojů.

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

Parametry

nID
Identifikátor příkazu tlačítka, jehož neurčitý stav je nastaven nebo vymazán.

bIndeterminate
TRUE pokud chcete nastavit neurčitý stav zadaného tlačítka, FALSE vymažte ho.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Neurčitá tlačítka se zobrazují šedě, například způsob, jakým by tlačítko tučného písma na panelu nástrojů textového procesoru vypadalo, když vybraný text obsahuje tučné i běžné znaky. Pokud chcete změnit více než jeden stav tlačítka, zvažte místo toho volání SetState .

CToolBarCtrl::InsertButton

Vloží tlačítko do ovládacího prvku panelu nástrojů.

BOOL InsertButton(
    int nIndex,
    LPTBBUTTON lpButton);

Parametry

nIndex
Index tlačítka založený na nule Tato funkce vloží nové tlačítko vlevo od tohoto tlačítka.

lpButton
TBBUTTON Adresa struktury obsahující informace o tlačítku, které chcete vložit. Podívejte CToolBarCtrl::AddButtons se na popis TBBUTTON struktury.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Obrázek nebo řetězec, jehož index, který zadáte, byl dříve přidán do seznamu ovládacího prvku panelu nástrojů pomocí , AddBitmapAddStringa/nebo AddStrings.

CToolBarCtrl::InsertMarkHitTest

Načte informace o značce vložení pro bod na panelu nástrojů.

BOOL InsertMarkHitTest(
    LPPOINT ppt,
    LPTBINSERTMARK ptbim) const;

Parametry

ppt
Ukazatel na POINT strukturu, která obsahuje souřadnice testu hitů vzhledem k oblasti klienta panelu nástrojů.

ptbim
Ukazatel na TBINSERTMARK strukturu, která obdrží informace o značce vložení.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Tato členová funkce implementuje chování zprávy TB_INSERTMARKHITTESTWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::IsButtonChecked

Určuje, zda je zadané tlačítko v ovládacím prvku panelu nástrojů zaškrtnuté.

BOOL IsButtonChecked(int nID) const;

Parametry

nID
Identifikátor příkazu tlačítka na panelu nástrojů

Návratová hodnota

Nenulové, pokud je tlačítko zaškrtnuté; jinak nula.

Poznámky

Zvažte volání GetState , pokud chcete načíst více než jeden stav tlačítka.

CToolBarCtrl::IsButtonEnabled

Určuje, zda je zadané tlačítko v ovládacím prvku panelu nástrojů povoleno.

BOOL IsButtonEnabled(int nID) const;

Parametry

nID
Identifikátor příkazu tlačítka na panelu nástrojů

Návratová hodnota

Nenulové, pokud je tlačítko povoleno; jinak nula.

Poznámky

Zvažte volání GetState , pokud chcete načíst více než jeden stav tlačítka.

CToolBarCtrl::IsButtonHidden

Určuje, zda je zadané tlačítko v ovládacím prvku panelu nástrojů skryté.

BOOL IsButtonHidden(int nID) const;

Parametry

nID
Identifikátor příkazu tlačítka na panelu nástrojů

Návratová hodnota

Nenulové, pokud je tlačítko skryté; jinak nula.

Poznámky

Zvažte volání GetState , pokud chcete načíst více než jeden stav tlačítka.

CToolBarCtrl::IsButtonHighlighted

Zkontroluje stav zvýraznění tlačítka panelu nástrojů.

BOOL IsButtonHighlighted(int nID) const;

Parametry

nID
[v] ID příkazu pro tlačítko panelu nástrojů.

Návratová hodnota

Kladné celé číslo, pokud je tlačítko zvýrazněné, 0, pokud tlačítko není zvýrazněné, nebo -1, pokud dojde k chybě.

CToolBarCtrl::IsButtonIndeterminate

Určuje, zda je zadané tlačítko v ovládacím prvku panelu nástrojů neurčité.

BOOL IsButtonIndeterminate(int nID) const;

Parametry

nID
[v] Identifikátor příkazu tlačítka na panelu nástrojů

Návratová hodnota

Kladné celé číslo, pokud je tlačítko neurčité, nula, pokud tlačítko není neurčité, nebo -1, pokud dojde k chybě.

Poznámky

Neurčitá tlačítka jsou zobrazena šedě, například způsob, jakým tlačítko tučné na panelu nástrojů wordového procesoru vypadá, když vybraný text obsahuje tučné i běžné znaky. Zvažte volání GetState , pokud chcete načíst více než jeden stav tlačítka.

CToolBarCtrl::IsButtonPressed

Určuje, zda je zadané tlačítko v ovládacím prvku panelu nástrojů stisknuto.

BOOL IsButtonPressed(int nID) const;

Parametry

nID
Identifikátor příkazu tlačítka na panelu nástrojů

Návratová hodnota

Nenulové, pokud je tlačítko stisknuto, jinak nula.

Poznámky

Zvažte volání GetState , pokud chcete načíst více než jeden stav tlačítka.

CToolBarCtrl::LoadImages

Načte rastrové obrázky do seznamu obrázků ovládacího prvku panelu nástrojů.

void LoadImages(
    int iBitmapID,
    HINSTANCE hinst);

Parametry

iBitmapID
ID rastrového obrázku, který obsahuje obrázky, které se mají načíst. Chcete-li zadat vlastní rastrový zdroj, nastavte tento parametr na ID rastrového prostředku a nastavte hInst na NULL. Zdroj rastrového obrázku se přidá do seznamu obrázků jako jeden obrázek. Standardní systémově definované rastrové obrázky můžete přidat nastavením hinst HINST_COMMCTRL a nastavením tohoto parametru na jedno z následujících ID:

ID rastrového obrázku Popis
IDB_HIST_LARGE_COLOR Rastrové obrázky Průzkumníka ve velké velikosti
IDB_HIST_SMALL_COLOR Explorer bitmaps in small size
IDB_STD_LARGE_COLOR Standardní rastrové obrázky ve velké velikosti
IDB_STD_SMALL_COLOR Standardní rastrové obrázky v malé velikosti
IDB_VIEW_LARGE_COLOR Zobrazení rastrových obrázků ve velké velikosti
IDB_VIEW_SMALL_COLOR Zobrazení rastrových obrázků v malé velikosti

hinst
Obslužný rutina instance programu volající aplikaci. Tento parametr může být HINST_COMMCTRL načtení standardního seznamu imagí.

Poznámky

Tato členová funkce implementuje chování zprávy TB_LOADIMAGESWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::MapAccelerator

Mapuje znak akcelerátoru na tlačítko panelu nástrojů.

BOOL MapAccelerator(
    TCHAR chAccel,
    UINT* pIDBtn);

Parametry

chAccel
Znak akcelerátoru, který se má namapovat. Tento znak je stejný znak, který je podtržený v textu tlačítka.

pIDBtn
Ukazatel na UINT objekt, který obdrží identifikátor příkazu tlačítka, který odpovídá akcelerátoru zadanému v chAccel.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Tato členová funkce implementuje chování zprávy TB_MAPACCELERATORWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::MarkButton

Nastaví stav zvýraznění daného tlačítka v ovládacím prvku panelu nástrojů.

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

Parametry

nID
Identifikátor tlačítka.

fHighlight
Určuje stav zvýraznění, který se má nastavit. Ve výchozím nastavení . TRUE Pokud je nastavená hodnota FALSE, je tlačítko nastaveno na výchozí stav.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Tato členová funkce implementuje chování zprávy TB_MARKBUTTONWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::MoveButton

Přesune tlačítko z jednoho indexu do druhého.

BOOL MoveButton(
    UINT nOldPos,
    UINT nNewPos);

Parametry

nOldPos
Index tlačítka založený na nule, který se má přesunout.

nNewPos
Index cíle tlačítka založený na nule.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Tato členová funkce implementuje chování zprávy TB_MOVEBUTTONWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::PressButton

Stiskne nebo uvolní zadané tlačítko v ovládacím prvku panelu nástrojů.

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

Parametry

nID
[v] Identifikátor příkazu tlačítka, který se má stisknout nebo uvolnit

bPress
[v] TRUE stisknutím zadaného tlačítka; FALSE a uvolněte zadané tlačítko. Výchozí hodnota je TRUE.

Návratová hodnota

TRUEpokud je metoda úspěšná; v opačném případě . FALSE

Poznámky

Pokud chcete změnit více než jeden stav tlačítka, zvažte místo toho volání SetState .

Tato metoda odešle TB_PRESSBUTTON zprávu popsanou v sadě Windows SDK.

CToolBarCtrl::ReplaceBitmap

Nahradí existující rastrový obrázek v aktuálním ovládacím prvku panelu nástrojů novým rastrovým obrázkem.

BOOL ReplaceBitmap(LPTBREPLACEBITMAP pReplaceBitmap);

Parametry

pReplaceBitmap
[v] Ukazatel na TBREPLACEBITMAP strukturu, která popisuje rastrový obrázek, který se má nahradit, a nový rastrový obrázek.

Návratová hodnota

TRUEpokud je tato metoda úspěšná; v opačném případě . FALSE

Poznámky

Tato metoda odešle TB_REPLACEBITMAP zprávu popsanou v sadě Windows SDK.

Příklad

Následující příklad kódu nahradí rastrový obrázek pro standardní panel nástrojů jiným rastrovým obrázkem.

{
   // 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

Obnoví stav ovládacího prvku panelu nástrojů z umístění v registru určeném parametry.

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

Parametry

hKeyRoot
Identifikuje aktuálně otevřený klíč v registru nebo některou z následujících předdefinovaných hodnot vyhrazených popisovačů:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

lpszSubKey
Odkazuje na NULLřetězec -terminated obsahující název podklíče, ke kterému je přidružena hodnota. Tento parametr může být NULL nebo ukazatel na prázdný řetězec. Pokud je NULLparametr , hodnota se přidá do klíče identifikovaného parametrem hKeyRoot .

lpszValueName
Odkazuje na řetězec obsahující název hodnoty, kterou chcete načíst. Pokud v klíči ještě není hodnota s tímto názvem, funkce ji přidá do klíče.

CToolBarCtrl::SaveState

Uloží stav ovládacího prvku panelu nástrojů do umístění v registru určeném parametry.

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

Parametry

hKeyRoot
Identifikuje aktuálně otevřený klíč v registru nebo některou z následujících předdefinovaných hodnot vyhrazených popisovačů:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

lpszSubKey
Odkazuje na NULLřetězec -terminated obsahující název podklíče, ke kterému je přidružena hodnota. Tento parametr může být NULL nebo ukazatel na prázdný řetězec. Pokud je NULLparametr , hodnota se přidá do klíče identifikovaného parametrem hKeyRoot .

lpszValueName
Odkazuje na řetězec obsahující název hodnoty, kterou chcete nastavit. Pokud v klíči ještě není hodnota s tímto názvem, funkce ji přidá do klíče.

CToolBarCtrl::SetAnchorHighlight

Nastaví nastavení zvýraznění ukotvení panelu nástrojů.

BOOL SetAnchorHighlight(BOOL fAnchor = TRUE);

Parametry

fAnchor
[v] Určuje, jestli je zvýraznění ukotvení povolené nebo zakázané. Pokud je tato hodnota nenulová, zvýraznění ukotvení se povolí. Pokud je tato hodnota nula, zvýraznění ukotvení se zakáže.

Návratová hodnota

Předchozí nastavení ukotvení. Pokud bylo zvýraznění povoleno, je tato hodnota nenulová. Pokud zvýraznění nebylo povoleno, je tato hodnota nula.

Poznámky

Tato metoda implementuje chování zprávy TB_SETANCHORHIGHLIGHTWin32 , jak je popsáno v sadě Windows SDK.

CToolBarCtrl::SetBitmapSize

Nastaví velikost skutečných rastrových obrázků, které se mají přidat do ovládacího prvku panelu nástrojů.

BOOL SetBitmapSize(CSize size);

Parametry

size
Šířka a výška rastrových obrázků v pixelech

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Tato funkce musí být volána pouze před přidáním rastrových obrázků na panel nástrojů. Pokud aplikace explicitně nenastaví velikost rastrového obrázku, nastaví se ve výchozím nastavení na 16 až 15 pixelů.

CToolBarCtrl::SetButtonInfo

Nastaví informace pro existující tlačítko na panelu nástrojů.

BOOL SetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi);

Parametry

nID
Identifikátor tlačítka.

ptbbi
Ukazatel na TBBUTTONINFO strukturu, která přijímá informace o tlačítku.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Členová funkce implementuje chování zprávy TB_SETBUTTONINFOWin32 , jak je popsáno v sadě Windows SDK.

CToolBarCtrl::SetButtonSize

Nastaví velikost tlačítek v ovládacím prvku panelu nástrojů.

BOOL SetButtonSize(CSize size);

Parametry

size
Šířka a výška tlačítek v pixelech

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Velikost tlačítka musí být vždy alespoň tak velká, jako je velikost rastrového obrázku, která je uzavřena. Tato funkce musí být volána pouze před přidáním rastrových obrázků na panel nástrojů. Pokud aplikace explicitně nenastaví velikost tlačítka, nastaví se ve výchozím nastavení na 24 až 22 pixelů.

Příklad

Podívejte se na příklad pro CToolBar::GetToolBarCtrl.

CToolBarCtrl::SetButtonStructSize

Určuje velikost TBBUTTON struktury.

void SetButtonStructSize(int nSize);

Parametry

nSize
Velikost struktury v bajtech TBBUTTON

Poznámky

Pokud chcete do struktury uložit další data TBBUTTON , můžete buď odvodit novou strukturu, TBBUTTONpřidat potřebné členy, nebo vytvořit novou strukturu, která obsahuje TBBUTTON strukturu jako její první člen. Potom byste tuto funkci volali, aby panel nástrojů sděloval velikost nové struktury.

Další CToolBarCtrl::AddButtons informace o struktuře TBBUTTON

CToolBarCtrl::SetButtonWidth

Nastaví minimální a maximální šířku tlačítka v ovládacím prvku panelu nástrojů.

BOOL SetButtonWidth(
    int cxMin,
    int cxMax);

Parametry

cxMin
Minimální šířka tlačítka v pixelech Tlačítka panelu nástrojů nebudou nikdy užší než tato hodnota.

cxMax
Maximální šířka tlačítka v pixelech Pokud je text tlačítka příliš široký, ovládací prvek ho zobrazí se třemi tečkami.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Tato členová funkce implementuje chování zprávy TB_SETBUTTONWIDTHWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::SetCmdID

Nastaví identifikátor příkazu, který se odešle do okna vlastníka při stisknutí zadaného tlačítka.

BOOL SetCmdID(
    int nIndex,
    UINT nID);

Parametry

nIndex
Nulový index tlačítka, jehož ID příkazu se má nastavit.

nID
ID příkazu pro nastavení vybraného tlačítka.

Návratová hodnota

Vrátí nenulové hodnoty, pokud jsou úspěšné; jinak nula.

CToolBarCtrl::SetColorScheme

Nastaví barevné schéma aktuálního ovládacího prvku panelu nástrojů.

void SetColorScheme(const COLORSCHEME* lpColorScheme);

Parametry

lpColorScheme
[v] Ukazatel na COLORSCHEME strukturu, která popisuje barvu zvýraznění a barvu stínu ovládacího prvku panelu nástrojů.

Poznámky

Tato metoda nemá žádný vliv, pokud je nastaven vizuální motiv systému Windows Vista.

Tato metoda odešle TB_SETCOLORSCHEME zprávu popsanou v sadě Windows SDK.

Příklad

Následující příklad kódu nastaví barevné schéma pro aktuální panel nástrojů ovládacího prvku. V příkladu kódu jsou levé a horní okraje každého tlačítka nástroje červené a pravé a dolní okraje modré. Když uživatel stiskne tlačítko, červené okraje tlačítka se změní na modrou a jeho modré okraje se změní na červenou.

//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

Nastaví seznam obrázků, který bude ovládací prvek panelu nástrojů používat k zobrazení zakázaných tlačítek.

CImageList* SetDisabledImageList(CImageList* pImageList);

Parametry

pImageList
Ukazatel na CImageList objekt obsahující obrázky, které má ovládací prvek panelu nástrojů použít k zobrazení obrázků zakázaných tlačítek.

Návratová hodnota

Ukazatel na CImageList objekt, který dříve používal ovládací prvek panelu nástrojů k zobrazení obrázků zakázaných tlačítek.

Poznámky

Tato členová funkce implementuje chování zprávy TB_SETDISABLEDIMAGELISTWin32, jak je popsáno v sadě Windows SDK. Implementace SetDisabledImageList MFC používá CImageList objekt obsahující zakázané obrázky tlačítek ovládacího prvku panelu nástrojů, nikoli popisovač seznamu obrázků.

CToolBarCtrl::SetDrawTextFlags

Nastaví příznaky ve funkci DrawTextWin32 , která se používá k vykreslení textu v zadaném obdélníku, formátované podle toho, jak jsou příznaky nastaveny.

DWORD SetDrawTextFlags(
    DWORD dwMask,
    DWORD dwDTFlags);

Parametry

dwMask
Kombinace jednoho nebo více DT_ příznaků zadaných ve funkci DrawTextWin32, která označuje, které bity se dwDTFlags použijí při kreslení textu.

dwDTFlags
Kombinace jednoho nebo více DT_ příznaků zadaných ve funkci DrawTextWin32, která označuje, jak se bude text tlačítka kreslit. Tato hodnota se předá DrawText při vykreslení textu tlačítka.

Návratová hodnota

A DWORD obsahující předchozí příznaky kreslení textu.

Poznámky

Tato členová funkce implementuje chování zprávy TB_SETDRAWTEXTFLAGSWin32, jak je popsáno v sadě Windows SDK. Tato členová funkce nastaví příznaky ve funkci DrawTextWin32 , která nakreslí text v zadaném obdélníku, formátovaný podle toho, jak jsou příznaky nastaveny.

CToolBarCtrl::SetExtendedStyle

Nastaví rozšířené styly pro ovládací prvek panelu nástrojů.

DWORD SetExtendedStyle(DWORD dwExStyle);

Parametry

dwExStyle
Hodnota určující nové rozšířené styly. Tento parametr může být kombinací rozšířených stylů panelu nástrojů.

Návratová hodnota

A DWORD , který představuje předchozí rozšířené styly. Seznam stylů naleznete v části Panel nástrojů Rozšířené styly v sadě Windows SDK.

Poznámky

Tato členová funkce implementuje chování zprávy TB_SETEXTENDEDSTYLEWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::SetHotImageList

Nastaví seznam obrázků, který bude ovládací prvek panelu nástrojů používat k zobrazení "horkých" tlačítek.

CImageList* SetHotImageList(CImageList* pImageList);

Parametry

pImageList
Ukazatel na CImageList objekt obsahující obrázky, které má ovládací prvek panelu nástrojů použít k zobrazení obrázků hot button.

Návratová hodnota

Ukazatel na CImageList objekt, který dříve používal ovládací prvek panelu nástrojů k zobrazení obrázků hot button.

Poznámky

Tato členová funkce implementuje chování zprávy TB_SETHOTIMAGELISTWin32, jak je popsáno v sadě Windows SDK.

Implementace SetHotImageList KNIHOVNY MFC používá CImageList objekt obsahující obrázky hot button ovládacího prvku panelu nástrojů, nikoli popisovač seznamu obrázků. Když je ukazatel nad ukazatelem, zobrazí se zvýrazněné horké tlačítko.

CToolBarCtrl::SetHotItem

Nastaví horkou položku na panelu nástrojů.

int SetHotItem(int nHot);

Parametry

nHot
Číslo indexu založeného na nule položky, která bude hotová. Pokud je tato hodnota -1, nebude žádná z položek horká.

Návratová hodnota

Index předchozí horké položky nebo -1, pokud nebyla žádná hotová položka.

Poznámky

Tato členová funkce implementuje chování zprávy TB_SETHOTITEMWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::SetImageList

Nastaví seznam obrázků, který bude panel nástrojů používat k zobrazení tlačítek, která jsou ve výchozím stavu.

CImageList* SetImageList(CImageList* pImageList);

Parametry

pImageList
Ukazatel na CImageList objekt obsahující obrázky, které má ovládací prvek panelu nástrojů použít k zobrazení obrázků tlačítek ve výchozím stavu.

Návratová hodnota

Ukazatel na CImageList objekt, který dříve používal ovládací prvek panelu nástrojů k zobrazení obrázků tlačítek ve výchozím stavu.

Poznámky

Tato členová funkce implementuje chování zprávy TB_SETIMAGELISTWin32, jak je popsáno v sadě Windows SDK.

Implementace SetImageList MFC používá CImageList objekt obsahující obrázky tlačítek ovládacího prvku panelu nástrojů, nikoli popisovač seznamu obrázků.

CToolBarCtrl::SetIndent

Nastaví odsazení prvního tlačítka v ovládacím prvku panelu nástrojů.

BOOL SetIndent(int iIndent);

Parametry

iIndent
Hodnota určující odsazení v pixelech.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

CToolBarCtrl::SetInsertMark

Nastaví aktuální značku vložení panelu nástrojů.

void SetInsertMark(TBINSERTMARK* ptbim);

Parametry

ptbim
Ukazatel na TBINSERTMARK strukturu, která obsahuje značku vložení.

Poznámky

Tato členová funkce implementuje chování zprávy TB_SETINSERTMARKWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::SetInsertMarkColor

Nastaví barvu použitou k vykreslení značky vložení panelu nástrojů.

COLORREF SetInsertMarkColor(COLORREF clrNew);

Parametry

clrNew
COLORREF Hodnota, která obsahuje novou barvu značky vložení.

Návratová hodnota

COLORREF Hodnota, která obsahuje předchozí barvu značky vložení.

Poznámky

Tato členová funkce implementuje chování zprávy TB_SETINSERTMARKCOLORWin32, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::SetMaxTextRows

Nastaví maximální počet textových řádků zobrazených na tlačítku panelu nástrojů.

BOOL SetMaxTextRows(int iMaxRows);

Parametry

iMaxRows
Maximální počet řádků, které se mají nastavit.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

CToolBarCtrl::SetMetrics

Nastaví metriky objektu CToolBarCtrl .

void SetMetrics(LPTBMETRICS ptbm);

Parametry

ptbm
Ukazatel na TBMETRICS strukturu objektu CToolBarCtrl .

Poznámky

Tato členová funkce emuluje funkce TB_SETMETRICS zprávy, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::SetOwner

Nastaví okno vlastníka pro ovládací prvek panelu nástrojů.

void SetOwner(CWnd* pWnd);

Parametry

pWnd
Ukazatel na CWnd objekt nebo CWndodvozený objekt, který bude novým oknem vlastníka ovládacího prvku panelu nástrojů.

Poznámky

Okno vlastníka je okno, které přijímá oznámení z panelu nástrojů.

CToolBarCtrl::SetPadding

Nastaví vodorovné a svislé odsazení aktuálního ovládacího prvku panelu nástrojů.

DWORD SetPadding(
    int nHorzPadding,
    int nVertPadding);

Parametry

nHorzPadding
[v] Určuje vodorovné odsazení ovládacího prvku panelu nástrojů v pixelech.

nVertPadding
[v] Určuje svislé odsazení ovládacího prvku panelu nástrojů v pixelech.

Návratová hodnota

Jejíž DWORD nízké slovo obsahuje předchozí hodnotu vodorovného odsazení a jehož vysoké slovo obsahuje předchozí svislou hodnotu odsazení. Hodnoty odsazení se měří v pixelech.

Poznámky

Tato metoda odešle TB_SETPADDING zprávu popsanou v sadě Windows SDK.

Příklad

Následující příklad kódu nastaví vodorovné a svislé odsazení aktuálního ovládacího prvku panelu nástrojů na 20 pixelů.

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

CToolBarCtrl::SetPressedImageList

Nastaví seznam obrázků, který aktuální ovládací prvek panelu nástrojů používá k reprezentaci tlačítek v stisknutém stavu.

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

Parametry

iImageID
[v] Index seznamu obrázků založený na nule. Pokud použijete jenom jeden seznam obrázků, nastavte tento parametr na nulu.

pImageList
[v] Ukazatel na CImageList seznam nových obrázků.

Návratová hodnota

Ukazatel na CImageList seznam obrázku, který obsahuje předchozí seznam obrázků pro aktuální ovládací prvek, nebo NULL pokud nebyl nastaven žádný takový seznam obrázků.

Poznámky

Tato metoda odešle TB_SETPRESSEDIMAGELIST zprávu popsanou v sadě Windows SDK.

Příklad

Následující příklad kódu nastaví seznam stisknutých obrázků tak, aby byl stejný jako výchozí seznam obrázků.

{
   // 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

Požádá ovládací prvek panelu nástrojů, aby se změnil na požadovaný počet řádků.

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

Parametry

nRows
Požadovaný počet řádků

bLarger
Určuje, jestli chcete použít více řádků nebo méně řádků, pokud panel nástrojů nejde změnit na požadovaný počet řádků.

lpRect
Odkazuje na CRect objekt nebo RECT strukturu, která obdrží nový ohraničující obdélník panelu nástrojů.

Poznámky

Pokud se panel nástrojů nemůže změnit na požadovaný počet nebo řádky, změní velikost na další větší nebo menší platnou velikost v závislosti na hodnotě bLarger. Pokud bLarger ano TRUE, bude nový počet řádků větší než požadovaný počet. Pokud bLarger ano FALSE, bude nový počet řádků menší než požadovaný počet.

Zadaný počet řádků je pro panel nástrojů platný, pokud lze tlačítka uspořádat tak, aby všechny řádky měly stejný počet tlačítek (s výjimkou posledního řádku). Například panel nástrojů, který obsahuje čtyři tlačítka, nemůže mít velikost na tři řádky, protože poslední dva řádky by musely být kratší. Pokud jste se pokusili o jeho velikost na tři řádky, získali byste čtyři řádky, pokud bLarger by byly TRUE a dva řádky, pokud by bLarger byly FALSE.

Pokud jsou na panelu nástrojů oddělovače, jsou pravidla, kdy je daný počet řádků platný, složitější. Rozložení se vypočítá tak, že se skupiny tlačítek (tlačítka s oddělovačem před prvním a posledním tlačítkem ve skupině) nikdy nerozčlení na několik řádků, pokud se skupina nevejde na jeden řádek.

Pokud se skupina nevejde na jeden řádek, začne další skupina na dalším řádku i v případě, že by se vešla na řádek, kde velká skupina skončila. Účelem tohoto pravidla je zvýraznit oddělení mezi velkými skupinami. Výsledné svislé oddělovače se počítají jako řádky.

Všimněte si také, že SetRows členová funkce vždy zvolí rozložení, které bude mít za následek nejmenší velikost panelu nástrojů. Vytvoření panelu TBSTYLE_WRAPABLE nástrojů se stylem a následná změna velikosti ovládacího prvku jednoduše použije metodu uvedenou výše s ohledem na šířku ovládacího prvku.

Tuto funkci lze volat pouze pro panely nástrojů vytvořené pomocí TBSTYLE_WRAPABLE stylu.

CToolBarCtrl::SetState

Nastaví stav zadaného tlačítka v ovládacím prvku panelu nástrojů.

BOOL SetState(
    int nID,
    UINT nState);

Parametry

nID
Identifikátor příkazu tlačítka.

nState
Příznaky stavu. Může to být kombinace hodnot uvedených pro stavy tlačítek v CToolBarCtrl::AddButtons.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Tato funkce je zvlášť praktická, pokud chcete nastavit více než jeden ze stavů tlačítek. Chcete-li nastavit pouze jeden stav, použijte jednu z následujících členských funkcí: EnableButton, CheckButton, HideButton, Indeterminate, nebo PressButton.

CToolBarCtrl::SetStyle

Nastaví styly ovládacího prvku panelu nástrojů.

void SetStyle(DWORD dwStyle);

Parametry

dwStyle
Obsahuje DWORD kombinaci stylů ovládacích prvků panelu nástrojů, jak je popsáno v sadě Windows SDK.

CToolBarCtrl::SetToolTips

Přidruží ovládací prvek popisku nástroje k ovládacímu prvku panelu nástrojů.

void SetToolTips(CToolTipCtrl* pTip);

Parametry

pTip
Ukazatel na CToolTipCtrl objekt.

CToolBarCtrl::SetWindowTheme

Nastaví vizuální styl objektu CToolBarCtrl .

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parametry

pszSubAppName
Ukazatel na řetězec Unicode, který obsahuje vizuální styl panelu nástrojů, který chcete nastavit.

Návratová hodnota

Vrácená hodnota se nepoužívá.

Poznámky

Tato členová funkce emuluje funkce TB_SETWINDOWTHEME zprávy, jak je popsáno v sadě Windows SDK.

Viz také

Mfc – ukázka CMNCTRL1
Mfc – ukázka MFCIE
CWnd Třída
Graf hierarchie
CToolBar Třída