CMFCOutlookBarPane – třída

Článek
10/12/2023

Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.

Ovládací prvek odvozený z CMFCToolBar třídy, který lze vložit do panelu Aplikace Outlook ( CMFCOutlookBar třída). Podokno pruhu Outlooku obsahuje sloupec velkých tlačítek. Uživatel se může posunout nahoru a dolů v seznamu tlačítek, pokud je větší než podokno. Když uživatel odpojil podokno panelu Outlooku z panelu Outlooku, může se v okně hlavního rámce ukotvit nebo ukotvit.

Syntaxe

class CMFCOutlookBarPane : public CMFCToolBar

Členové

Veřejné konstruktory

Jméno	popis
`CMFCOutlookBarPane::CMFCOutlookBarPane`	Výchozí konstruktor.
`CMFCOutlookBarPane::~CMFCOutlookBarPane`	Destruktor.

Veřejné metody

Jméno	popis
CMFCOutlookBarPane::AddButton	Přidá tlačítko do podokna panelu Outlooku.
CMFCOutlookBarPane::CanBeAttached	Určuje, zda lze podokno ukotvit do jiného podokna nebo okna rámečku. (Přepsání CBasePane::CanBeAttached.)
`CMFCOutlookBarPane::CanBeRestored`	Určuje, zda systém může obnovit panel nástrojů do původního stavu po přizpůsobení. (Přepsání CMFCToolBar::CanBeRestored.)
CMFCOutlookBarPane::ClearAll	Uvolní prostředky používané obrázky v podokně panelu Outlooku.
CMFCOutlookBarPane::Create	Vytvoří podokno panelu Outlooku.
`CMFCOutlookBarPane::CreateObject`	Používá se architekturou k vytvoření dynamické instance tohoto typu třídy.
`CMFCOutlookBarPane::Dock`	Volá se rozhraním pro ukotvení podokna pruhu Outlooku. (Přepsání `CPane::Dock`.)
CMFCOutlookBarPane::EnablePageScrollMode	Určuje, jestli šipky posuvníku v podokně panelu Outlooku přechádí seznam tlačítek po stránce nebo po tlačítku.
CMFCOutlookBarPane::GetRegularColor	Vrátí běžnou (nevybrali) barvu textu v podokně pruhu Outlooku.
`CMFCOutlookBarPane::GetThisClass`	Používá se architekturou k získání ukazatele na CRuntimeClass objektu, který je přidružen k tomuto typu třídy.
CMFCOutlookBarPane::IsBackgroundTexture	Určuje, zda je pro podokno pruhu Outlooku načten obrázek pozadí.
`CMFCOutlookBarPane::IsChangeState`	Určuje, zda lze ukotvit plovoucí podokno. (Přepsání `CPane::IsChangeState`.)
CMFCOutlookBarPane::IsDrawShadedHighlight	Určuje, jestli je ohraničení tlačítka stínováno, když je tlačítko zvýrazněné a zobrazí se obrázek pozadí.
`CMFCOutlookBarPane::OnBeforeFloat`	Volá se rozhraním, když se chystá plovoucí podokno. (Přepsání CPane::OnBeforeFloat.)
CMFCOutlookBarPane::RemoveButton	Odebere tlačítko se zadaným ID příkazu.
`CMFCOutlookBarPane::RestoreOriginalstate`	Obnoví původní stav panelu nástrojů. (Přepsání CMFCToolBar::RestoreOriginalState.)
CMFCOutlookBarPane::SetBackColor	Nastaví barvu pozadí.
CMFCOutlookBarPane::SetBackImage	Nastaví obrázek pozadí.
CMFCOutlookBarPane::SetDefaultState	Obnoví podokno panelu Outlooku na původní sadu tlačítek.
CMFCOutlookBarPane::SetExtraSpace	Nastaví počet pixelů odsazení použitých kolem tlačítek v podokně pruhu Outlooku.
CMFCOutlookBarPane::SetTextColor	Nastaví barvy běžného a zvýrazněného textu v podokně panelu Outlooku.
CMFCOutlookBarPane::SetTransparentColor	Nastaví průhlednou barvu podokna pruhu Outlooku.
`CMFCOutlookBarPane::SmartUpdate`	Používá se interně k aktualizaci panelu Outlooku. (Přepsání `CMFCToolBar::SmartUpdate`.)

Chráněné metody

Jméno	popis
CMFCOutlookBarPane::EnableContextMenuItems	Určuje, které položky místní nabídky se zobrazí v režimu přizpůsobení.
CMFCOutlookBarPane::RemoveAllButtons	Odebere všechna tlačítka z podokna panelu Outlooku. (Přepsání CMFCToolBar::RemoveAllButtons.)

Poznámky

Informace o tom, jak implementovat panel Aplikace Outlook, naleznete v tématu CMFCOutlookBar Třída.

Příklad pruhu Outlooku najdete v ukázkovém projektu OutlookDemo.

Příklad

Následující příklad ukazuje, jak používat různé metody CMFCOutlookBarPane třídy. Příklad ukazuje, jak vytvořit podokno pruhu Outlooku, povolit režim posouvání stránky, povolit ukotvení a nastavit barvu pozadí na panelu Outlooku. Tento fragment kódu je součástí ukázky více zobrazení Aplikace Outlook.

CMFCOutlookBarPane m_wndShortcutsPane1;

CImageList images;
images.Create(IDB_SHORTCUTS, 32, 0, RGB(255, 0, 255));

// Create first page:
m_wndShortcutsPane1.Create(&m_wndShortcutsBar, AFX_DEFAULT_TOOLBAR_STYLE, ID_SHORTCUTS_PANE_1);
// The this pointer points to a CMainFrame class which extends the CFrameWnd class
m_wndShortcutsPane1.SetOwner(this);
m_wndShortcutsPane1.EnableTextLabels();
m_wndShortcutsPane1.EnableDocking(CBRS_ALIGN_ANY);
m_wndShortcutsPane1.EnablePageScrollMode();
m_wndShortcutsPane1.SetBackColor(RGB(0, 255, 0));

m_wndShortcutsPane1.AddButton(images.ExtractIcon(0), _T("View 1"), ID_SHORTCUT_1);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(1), _T("View 2"), ID_SHORTCUT_2);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(2), _T("View 3"), ID_SHORTCUT_3);
m_wndShortcutsPane1.AddButton(images.ExtractIcon(3), _T("View 4"), ID_SHORTCUT_4);

Hierarchie dědičnosti

Požadavky

Záhlaví: afxoutlookbarpane.h

CMFCOutlookBarPane::AddButton

Přidá tlačítko do podokna panelu Outlooku.

BOOL AddButton(
    UINT uiImage,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    UINT uiImage,
    UINT uiLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    LPCTSTR szBmpFileName,
    LPCTSTR szLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HBITMAP hBmp,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1);

BOOL AddButton(
    HICON hIcon,
    LPCTSTR lpszLabel,
    UINT iIdCommand,
    int iInsertAt=-1,
    BOOL bAlphaBlend=FALSE);

Parametry

uiImage
[v] Určuje identifikátor zdroje rastrového obrázku.

lpszLabel
[v] Určuje text tlačítka.

iIdCommand
[v] Určuje ID ovládacího prvku tlačítka.

iInsertAt
[v] Určuje index založený na nule na stránce outlookového panelu, na které se má tlačítko vložit.

uiLabel
[v] ID prostředku řetězce.

szBmpFileName
[v] Určuje název souboru image disku, který se má načíst.

szLabel
[v] Určuje text tlačítka.

hBmp
[v] Úchyt rastrového obrázku tlačítka.

hIcon
[v] Úchyt ikony tlačítek.

Vrácená hodnota

TRUE, pokud bylo tlačítko úspěšně přidáno; jinak NEPRAVDA.

Poznámky

Tato metoda slouží k vložení nového tlačítka na stránku panelu Outlooku. Image tlačítka se dá načíst z prostředků aplikace nebo ze souboru disku.

Pokud je ID stránky zadané pomocí uiPageID -1, tlačítko se vloží na první stránku.

Pokud je index určený parametrem iInsertAt -1, tlačítko se přidá na konec stránky.

CMFCOutlookBarPane::CanBeAttached

Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.

virtual BOOL CanBeAttached() const;

Vrácená hodnota

Poznámky

CMFCOutlookBarPane::ClearAll

Uvolní prostředky používané obrázky v podokně panelu Outlooku.

void ClearAll();

Poznámky

Tato metoda přímo volá CMFCToolBarImages::Clear, který je volán na obrázcích, které používají podokno pruhu Aplikace Outlook.

CMFCOutlookBarPane::Create

Vytvoří podokno panelu Outlooku.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT uiID=(UINT)-1,
    DWORD dwControlBarStyle=0);

Parametry

pParentWnd
[v] Určuje nadřazené okno ovládacího prvku podokna panelu Outlooku. Nesmí být NULL.

dwStyle
[v] Styl okna. Seznam stylů oken najdete v tématu Styly oken.

UIID
[v] ID ovládacího prvku. Aby bylo možné uložit stav ovládacího prvku, musí být jedinečný.

dwControlBarStyle
[v] Určuje speciální styly, které definují chování ovládacího prvku podokna panelu Outlooku při odpojení od panelu Outlooku.

Vrácená hodnota

TRUE, pokud byla metoda úspěšná; jinak NEPRAVDA.

Poznámky

Chcete-li vytvořit CMFCOutlookBarPane objekt, nejprve zavolejte konstruktor a potom volání Create, který vytvoří ovládací prvek podokna panelu Aplikace Outlook a připojí ho k objektu CMFCOutlookBarPane .

Další informace o dwControlBarStyle CBasePane ::CreateEx.

CMFCOutlookBarPane::EnableContextMenuItems

Určuje, které položky místní nabídky se zobrazí v režimu přizpůsobení.

virtual BOOL EnableContextMenuItems(
    CMFCToolBarButton* pButton,
    CMenu* pPopup);

Parametry

pButton
[v] Ukazatel na tlačítko panelu nástrojů, na které uživatel klikl.

pPopup
[v] Ukazatel na místní nabídku.

Vrácená hodnota

Vrátí hodnotu TRUE, pokud má být zobrazena místní nabídka; jinak NEPRAVDA.

Poznámky

Tuto metodu přepište tak, aby upravte standardní místní nabídku rozhraní, která se zobrazí v režimu přizpůsobení.

Výchozí implementace zkontroluje režim přizpůsobení ( CMFCToolBar::IsCustomizeMode) a pokud je nastavena na HODNOTU TRUE, zakáže všechny místní položky nabídky s výjimkou Delete. Pak jednoduše předá vstupní parametry do CMFCToolBar::EnableContextMenuItems.

Poznámka

Místní nabídka je synonymem místní nabídky.

CMFCOutlookBarPane::EnablePageScrollMode

Určuje, jestli šipky posuvníku v podokně panelu Outlooku přechádí seznam tlačítek podle stránky nebo tlačítka po tlačítku.

void EnablePageScrollMode(BOOL bPageScroll=TRUE);

Parametry

bPageScroll
[v] Pokud je hodnota TRUE, povolte režim posouvání stránky. Pokud je hodnota FALSE, zakažte režim posouvání stránky.

CMFCOutlookBarPane::GetRegularColor

Vrátí běžnou (tj. nevybrali) barvu textu v podokně pruhu Outlooku.

DECLARE_MESSAGE_MAPCOLORREF GetRegularColor() const;

Vrácená hodnota

Aktuální barva textu jako hodnota barvy RGB.

Poznámky

Pomocí CMFCOutlookBarPane::SetTextColor nastavte aktuální (běžnou a vybranou) barvu textu na panelu Outlooku. Výchozí barvu textu můžete získat voláním funkce GetSysColor s indexem COLOR_WINDOW.

CMFCOutlookBarPane::IsBackgroundTexture

Určuje, zda je pro podokno pruhu Outlooku načten obrázek pozadí.

BOOL IsBackgroundTexture() const;

Vrácená hodnota

TRUE, pokud je k dispozici obrázek pozadí k zobrazení; jinak NEPRAVDA.

Poznámky

Obrázek na pozadí můžete přidat voláním funkce CMFCOutlookBarPane::SetBackImage .

Pokud neexistuje žádný obrázek pozadí, pozadí je vykresleno barvou určenou pomocí CMFCOutlookBarPane::SetBackColor.

CMFCOutlookBarPane::IsDrawShadedHighlight

Určuje, jestli je ohraničení tlačítka stínováno, když je tlačítko zvýrazněné a zobrazí se obrázek pozadí.

BOOL IsDrawShadedHighlight() const;

Vrácená hodnota

TRUE pokud ohraničení tlačítka jsou stínovány; jinak NEPRAVDA.

CMFCOutlookBarPane::RemoveAllButtons

Odebere všechna tlačítka z podokna panelu Outlooku.

virtual void RemoveAllButtons();

CMFCOutlookBarPane::RemoveButton

Odebere tlačítko se zadaným ID příkazu.

BOOL RemoveButton(UINT iIdCommand);

Parametry

iIdCommand
[v] Určuje ID příkazu tlačítka, které se má odebrat.

Vrácená hodnota

TRUE, pokud tlačítko bylo úspěšně odebráno; NEPRAVDA, pokud zadané ID příkazu není platné.

CMFCOutlookBarPane::SetBackColor

Nastaví barvu pozadí panelu Outlooku.

void SetBackColor(COLORREF color);

Parametry

Barev
[v] Určuje novou barvu pozadí.

Poznámky

Voláním této funkce nastavíte aktuální barvu pozadí pro panel Outlooku. Barva pozadí se používá jenom v případě, že neexistuje žádný obrázek pozadí.

CMFCOutlookBarPane::SetBackImage

Nastaví obrázek pozadí.

void SetBackImage(UINT uiImageID);

Parametry

uiImageID
[v] Určuje ID prostředku image.

Poznámky

Voláním této metody nastavíte obrázek pozadí na panelu Outlooku. Seznam obrázků na pozadí spravuje vložený CMFCToolBarImages Class objektu.

CMFCOutlookBarPane::SetDefaultState

Obnoví podokno panelu Outlooku na původní sadu tlačítek.

void SetDefaultState();

Poznámky

Tato metoda obnoví tlačítka panelu Outlooku do původní sady. Tato metoda je podobná CMFCOutlookBarPane::RestoreOriginalstates tím rozdílem, že neaktivuje překreslení podokna panelu Aplikace Outlook.

CMFCOutlookBarPane::SetExtraSpace

Nastaví počet pixelů odsazení použitých kolem tlačítek v podokně pruhu Outlooku.

void SetExtraSpace()

CMFCOutlookBarPane::SetTextColor

Nastaví barvy běžného a zvýrazněného textu v podokně panelu Outlooku.

void SetTextColor(
    COLORREF clrRegText,
    COLORREF clrSelText=0);

Parametry

clrRegText
[v] Určuje novou barvu pro nevýkonný text.

clrSelText
[v] Určuje novou barvu vybraného textu.

CMFCOutlookBarPane::SetTransparentColor

Nastaví průhlednou barvu podokna pruhu Outlooku.

void SetTransparentColor(COLORREF color);

Parametry

Barev
Určuje novou průhlednou barvu.

Poznámky

K zobrazení průhledných obrázků se vyžaduje průhledná barva. Všechny výskyty této barvy v obrázku se místo toho malují barvou pozadí. Neexistuje žádná kombinace pozadí a obrázků na popředí.

Viz také

Graf hierarchie
Třídy
CMFCToolBar – třída
CMFCOutlookBar – třída
CMFCOutlookBarTabCtrl – třída

Sdílet prostřednictvím

CMFCOutlookBarPane – třída

Syntaxe

Členové

Veřejné konstruktory

Veřejné metody

Chráněné metody

Poznámky

Příklad

Hierarchie dědičnosti

Požadavky

CMFCOutlookBarPane::AddButton

Parametry

Vrácená hodnota

Poznámky

CMFCOutlookBarPane::CanBeAttached

Vrácená hodnota

Poznámky

CMFCOutlookBarPane::ClearAll

Poznámky

CMFCOutlookBarPane::Create

Parametry

Vrácená hodnota

Poznámky

CMFCOutlookBarPane::EnableContextMenuItems

Parametry

Vrácená hodnota

Poznámky

CMFCOutlookBarPane::EnablePageScrollMode

Parametry

CMFCOutlookBarPane::GetRegularColor

Vrácená hodnota

Poznámky

CMFCOutlookBarPane::IsBackgroundTexture

Vrácená hodnota

Poznámky

CMFCOutlookBarPane::IsDrawShadedHighlight

Vrácená hodnota

CMFCOutlookBarPane::RemoveAllButtons

CMFCOutlookBarPane::RemoveButton

Parametry

Vrácená hodnota

CMFCOutlookBarPane::SetBackColor

Parametry

Poznámky

CMFCOutlookBarPane::SetBackImage

Parametry

Poznámky

CMFCOutlookBarPane::SetDefaultState

Poznámky

CMFCOutlookBarPane::SetExtraSpace

CMFCOutlookBarPane::SetTextColor

Parametry

CMFCOutlookBarPane::SetTransparentColor

Parametry

Poznámky

Viz také

Váš názor

Další materiály