CMFCOutlookBarPane – třída
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
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro