CMFCOutlookBarTabCtrl – třída

Ovládací prvek karty, který má vizuální vzhled navigačního podokna v aplikaci Microsoft Outlook. Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.

Syntaxe

class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl

Členové

Veřejné konstruktory

Název	Popis
CMFCOutlookBarTabCtrl::CMFCOutlookBarTabCtrl	Výchozí konstruktor.
CMFCOutlookBarTabCtrl::~CMFCOutlookBarTabCtrl	Destruktor.

Veřejné metody

Název	Popis
CMFCOutlookBarTabCtrl::AddControl	Přidá ovládací prvek Windows jako novou kartu na panelu Outlooku.
CMFCOutlookBarTabCtrl::CalcRectEdit	Volá se rozhraním k určení dimenzí textového pole, které se zobrazí, když uživatel přejmenuje kartu. (Přepsání CMFCBaseTabCtrl::CalcRectEdit.)
CMFCOutlookBarTabCtrl::CanShowFewerPageButtons	Volané architekturou během operací změny velikosti, aby bylo možné určit, jestli lze zobrazit méně tlačítek na kartě panelu Outlooku, než je aktuálně viditelné.
CMFCOutlookBarTabCtrl::CanShowMorePageButtons	Volané architekturou během operací změny velikosti, aby bylo možné určit, jestli se dá zobrazit více tlačítek na kartě pruhu Outlooku, než je aktuálně vidět.
CMFCOutlookBarTabCtrl::Create	Vytvoří ovládací prvek karty panelu Outlooku.
CMFCOutlookBarTabCtrl::CreateObject	Používá se architekturou k vytvoření dynamické instance tohoto typu třídy.
CMFCOutlookBarTabCtrl::EnableAnimation	Určuje, jestli je povolená animace, ke které dochází během přepínání mezi aktivními kartami.
CMFCOutlookBarTabCtrl::EnableInPlaceEdit	Určuje, jestli uživatel může upravit popisky textu na tlačítkách karet na panelu Outlooku. (Přepsání CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCOutlookBarTabCtrl::EnableScrollButtons	Volá se rozhraním, která umožňují uživatelům procházet tlačítka v podokně pruhu Outlooku.
CMFCOutlookBarTabCtrl::FindTargetWnd	Identifikuje podokno, které obsahuje zadaný bod. (Přepsání CMFCBaseTabCtrl::FindTargetWnd.)
CMFCOutlookBarTabCtrl::GetBorderSize	Vrátí velikost ohraničení ovládacího prvku Karta Aplikace Outlook.
CMFCOutlookBarTabCtrl::GetTabArea	Načte velikost a umístění oblasti tabulátoru ovládacího prvku tab. (Přepsání CMFCBaseTabCtrl::GetTabArea.)
CMFCOutlookBarTabCtrl::GetThisClass	Používá se architekturou k získání ukazatele na CRuntimeClass objektu, který je přidružen k tomuto typu třídy.
CMFCOutlookBarTabCtrl::GetVisiblePageButtons
CMFCOutlookBarTabCtrl::IsAnimation	Určuje, jestli je povolená animace, ke které dochází během přepínání mezi aktivními kartami.
CMFCOutlookBarTabCtrl::IsMode2003	Určuje, zda je ovládací prvek karta panelu aplikace Outlook v režimu, který emuluje aplikaci Microsoft Outlook 2003.
CMFCOutlookBarTabCtrl::IsPtInTabArea	Určuje, zda je bod uvnitř oblasti tabulátoru. (Přepsání CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCOutlookBarTabCtrl::IsTabDetachable	Určuje, zda je karta odpojená. (Přepsání CMFCBaseTabCtrl::IsTabDetachable.)
CMFCOutlookBarTabCtrl::OnChangeTabs	Volá se rozhraním při vložení nebo odebrání karty. (Přepsání CMFCBaseTabCtrl::OnChangeTabs.)
CMFCOutlookBarTabCtrl::OnShowFewerPageButtons	Volá se rozhraním pro zmenšení počtu tlačítek stránek karet, která jsou viditelná.
CMFCOutlookBarTabCtrl::OnShowMorePageButtons	Volá se rozhraním pro zvýšení počtu tlačítek stránek karet, která jsou viditelná.
CMFCOutlookBarTabCtrl::OnShowOptions	Zobrazí dialogové okno Možnosti navigačního podokna.
CMFCOutlookBarTabCtrl::RecalcLayout	Přepočítá vnitřní rozložení ovládacího prvku tab. (Přepsání CMFCBaseTabCtrl::RecalcLayout.)
CMFCOutlookBarTabCtrl::SetActiveTab	Nastaví aktivní kartu. (Přepsání CMFCBaseTabCtrl::SetActiveTab.)
CMFCOutlookBarTabCtrl::SetBorderSize	Nastaví velikost ohraničení ovládacího prvku Karta Aplikace Outlook.
CMFCOutlookBarTabCtrl::SetPageButtonTextAlign	Nastaví zarovnání popisků textu na tlačítkách karet na panelu Outlooku.
CMFCOutlookBarTabCtrl::SetToolbarImageList	Nastaví rastrový obrázek obsahující ikony zobrazené v dolní části panelu Outlooku v režimu Outlooku 2003 (viz CMFCOutlookBar – třída).
CMFCOutlookBarTabCtrl::SetVisiblePageButtons

Poznámky

Pokud chcete vytvořit panel Outlooku, který má dokovací podporu, použijte CMFCOutlookBar objekt k hostování ovládacího prvku karta pruhu Outlooku. Další informace naleznete v tématu CMFCOutlookBar Třída.

Příklad

Následující příklad ukazuje, jak inicializovat CMFCOutlookBarTabCtrl objekt a používat různé metody ve CMFCOutlookBarTabCtrl třídě. Příklad ukazuje, jak povolit místní úpravy textového popisku na tlačítkách stránek karty na panelu Outlooku, povolit animaci, povolit úchyty pro posouvání, které uživateli umožňují procházet tlačítka v podokně pruhu Outlooku, nastavit velikost ohraničení ovládacího prvku Karta Outlooku a nastavit zarovnání popisků textu na tlačítkách karet Outlooku na panelu Outlooku. Tento fragment kódu je součástí ukázky outlookové ukázky.

// CMFCOutlookBar& bar
CMFCOutlookBarTabCtrl *pOutlookBar = (CMFCOutlookBarTabCtrl*)bar.GetUnderlyingWindow();

pOutlookBar->EnableInPlaceEdit(TRUE);
pOutlookBar->EnableAnimation();
pOutlookBar->EnableScrollButtons();
pOutlookBar->SetBorderSize(10);
pOutlookBar->SetPageButtonTextAlign(TA_LEFT);

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCOutlookBarTabCtrl

Požadavky

Záhlaví: afxoutlookbartabctrl.h

CMFCOutlookBarTabCtrl::AddControl

Přidá ovládací prvek Windows jako novou kartu na panelu Outlooku.

void AddControl(
    CWnd* pWndCtrl,
    LPCTSTR lpszName,
    int nImageID=-1,
    BOOL bDetachable=TRUE,
    DWORD dwControlBarStyle=AFX_CBRS_FLOAT |  AFX_CBRS_CLOSE | AFX_CBRS_RESIZE |  CBRS_AFX_AUTOHIDE);

Parametry

pWndCtrl
[v] Ukazatel na ovládací prvek, který chcete přidat.

lpszName
[v] Určuje název karty.

bDetachable
[v] Pokud je hodnota TRUE, stránka se vytvoří jako odpojená.

nImageID
[v] Index obrázku v interním seznamu obrázků, aby se obrázek zobrazil na nové kartě.

dwControlBarStyle
[v] Určuje styl AFX_ CBRS_* pro zabalené ukotvení podoken.

Poznámky

Tato funkce slouží k přidání ovládacího prvku jako nové stránky panelu outlooku.

Tato funkce interně volá CMFCBaseTabCtrl::AddTab.

Pokud nastavíte bDetachable na TRUE, AddControl interně vytvoří CDockablePaneAdapter objekt a zabalí přidaný ovládací prvek. Automaticky nastaví třídu modulu runtime okna s kartami na třídu CMFCOutlookBar runtime třídy modulu runtime a třídy modulu runtime plovoucího rámce na CMultiPaneFrameWnd.

Příklad

Následující příklad ukazuje, jak použít metodu AddControl CMFCOutlookBarTabCtrl ve třídě. Tento fragment kódu je součástí ukázky outlookové ukázky.

// CMFCOutlookBarTabCtrl* pOutlookBar
// DWORD dwStyle = AFX_CBRS_FLOAT | AFX_CBRS_AUTOHIDE | AFX_CBRS_RESIZE
// CMFCOutlookBarPane pane1
// The third parameter is the image index.
pOutlookBar->AddControl(&pane1, _T("General"), 0, TRUE, dwStyle);

CMFCOutlookBarTabCtrl::CanShowFewerPageButtons

Volané architekturou během operací změny velikosti, aby bylo možné určit, zda lze zobrazit méně tlačítek stránek na panelu Outlooku, než je aktuálně viditelné.

virtual BOOL CanShowFewerPageButtons() const;

Návratová hodnota

PRAVDA, pokud je více než jedno tlačítko; jinak NEPRAVDA.

Poznámky

Ovládací prvek karta pruhu Outlooku dynamicky přidává nebo odebírá karty ze zobrazení v závislosti na tom, kolik místa je k dispozici. Tuto metodu používá architektura k usnadnění tohoto procesu.

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

Volané architekturou během operací změny velikosti, aby bylo možné určit, zda lze zobrazit více tlačítek stránek na panelu Outlooku, než je aktuálně vidět.

virtual BOOL CanShowMorePageButtons() const;

Návratová hodnota

TRUE, pokud jsou tlačítka, která nejsou aktuálně viditelná; jinak NEPRAVDA.

Poznámky

Ovládací prvek karta pruhu Outlooku dynamicky přidává nebo odebírá karty ze zobrazení v závislosti na tom, kolik místa je k dispozici. Tuto metodu používá architektura k usnadnění tohoto procesu.

CMFCOutlookBarTabCtrl::Create

Vytvoří ovládací prvek karty panelu Outlooku.

virtual BOOL Create(
    const CRect& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametry

Rect
[v] Určuje počáteční velikost a umístění v pixelech.

pParentWnd
[v] Odkazuje na nadřazené okno. Nesmí být NULL.

Nid
[v] ID ovládacího prvku.

Návratová hodnota

Nenulové, pokud byl ovládací prvek úspěšně vytvořen; jinak 0.

Poznámky

Ovládací prvky karty panelu aplikace Outlook jsou obvykle vytvořeny, když CMFCOutlookBar Třída řídí WM_CREATE zprávu procesu.

CMFCOutlookBarTabCtrl::EnableAnimation

Určuje, jestli je povolená animace, ke které dochází během přepínání mezi aktivními kartami.

static void EnableAnimation(BOOL bEnable=TRUE);

Parametry

bEnable
[v] Určuje, jestli má být animace povolená nebo zakázaná.

Poznámky

Voláním této funkce povolíte a zakážete animaci. Když uživatel otevře stránku karty, titulek stránky se posune nahoru nebo dolů, pokud je povolená animace. Pokud je animace zakázaná, stránka se okamžitě aktivuje.

Ve výchozím nastavení je animace povolená.

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

Určuje, jestli uživatel může upravit popisky textu na tlačítkách stránek karty na panelu Outlooku.

virtual void EnableInPlaceEdit(BOOL bEnable);

Parametry

bEnable
Pokud je hodnota TRUE, povolte místní úpravy textového popisku. Pokud je hodnota FALSE, zakažte místní úpravy.

Poznámky

Voláním této funkce povolíte nebo zakážete místní úpravy popisků textu na tlačítkách stránek karet. Ve výchozím nastavení je místní úpravy zakázané.

CMFCOutlookBarTabCtrl::EnableScrollButtons

Volal ho architektura, aby bylo možné povolit posuvníky, které uživateli umožňují procházet tlačítka v podokně pruhu Outlooku.

void EnableScrollButtons(
    BOOL bEnable = TRUE,
    BOOL bIsUp = TRUE,
    BOOL bIsDown = TRUE);

Parametry

bEnable
[v] Určuje, zda jsou zobrazena tlačítka pro posouvání.

BIsUp
[v] Určuje, zda je zobrazen horní posuvník.

BIsDown
[v] Určuje, zda je zobrazen dolní posuvník.

Poznámky

Povolí zobrazení tlačítek pro posouvání. Tato metoda je volána rozhraním, když se aktivní karta změní na obnovení posuvníků.

CMFCOutlookBarTabCtrl::GetBorderSize

Vrátí velikost ohraničení ovládacího prvku Karta Aplikace Outlook.

int GetBorderSize() const;

Návratová hodnota

Velikost ohraničení v pixelech.

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

int GetVisiblePageButtons() const;

Návratová hodnota

Poznámky

CMFCOutlookBarTabCtrl::IsAnimation

Určuje, jestli je povolená animace, ke které dochází během přepínání mezi aktivními kartami.

static BOOL IsAnimation();

Návratová hodnota

Nenulové, pokud je animace povolena; jinak 0.

Poznámky

Voláním funkce CMFCOutlookBarTabCtrl::EnableAnimation povolíte nebo zakážete animaci.

CMFCOutlookBarTabCtrl::IsMode2003

Určuje, zda je ovládací prvek karta panelu aplikace Outlook v režimu, který emuluje aplikaci Microsoft Outlook 2003.

BOOL IsMode2003() const;

Návratová hodnota

TRUE, pokud je ovládací prvek karta panelu Aplikace Outlook v režimu Aplikace Outlook 2003; jinak NEPRAVDA;

Poznámky

Tuto hodnotu nastaví CMFCOutlookBar::SetMode2003.

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

Volá se rozhraním pro zmenšení počtu tlačítek stránek karet, která jsou viditelná.

virtual void OnShowFewerPageButtons();

Poznámky

Tato metoda upraví počet tlačítek viditelných karet stránky při změně velikosti ovládacího prvku.

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

Volá se rozhraním pro zvýšení počtu tlačítek stránek karet, která jsou viditelná.

virtual void OnShowMorePageButtons();

Poznámky

Tato metoda upraví počet tlačítek stránek karet, která jsou viditelná při změně velikosti ovládacího prvku.

CMFCOutlookBarTabCtrl::OnShowOptions

Zobrazí dialogové okno Možnosti navigačního podokna.

virtual void OnShowOptions();

Poznámky

Dialogové okno Možnosti navigačního podokna umožňuje uživateli vybrat, která tlačítka stránek karet se mají zobrazit, a pořadí zobrazení.

Tato metoda je volána architekturou, když uživatel vybere položku nabídky Možnosti navigačního podokna z nabídky přizpůsobení ovládacího prvku.

CMFCOutlookBarTabCtrl::SetActiveTab

Nastaví aktivní kartu. Aktivní karta je otevřená s viditelným obsahem.

virtual BOOL SetActiveTab(int iTab);

Parametry

iTab
[v] Index založený na nule karty, který se má otevřít.

Návratová hodnota

Nenulové, pokud byla zadaná karta úspěšně otevřena; jinak 0.

Poznámky

Vizuální efekt nastavení aktivní karty závisí na tom, jestli jste povolili animaci. Další informace naleznete v tématu CMFCOutlookBarTabCtrl::EnableAnimation.

CMFCOutlookBarTabCtrl::SetBorderSize

Nastaví velikost ohraničení ovládacího prvku Karta Aplikace Outlook.

void SetBorderSize(int nBorderSize);

Parametry

nBorderSize
[v] Určuje novou velikost ohraničení v pixelech.

Poznámky

Nastaví novou velikost ohraničení a přepočítá rozložení okna outlooku.

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Nastaví zarovnání popisků textu na tlačítkách karet na panelu Outlooku.

void SetPageButtonTextAlign(
    UINT uiAlign,
    BOOL bRedraw=TRUE);

Parametry

uiAlign
[v] Určuje zarovnání textu.

bRedraw
[v] Pokud je hodnota TRUE, okno aplikace Outlook bude překresleno.

Poznámky

Pomocí této funkce můžete změnit zarovnání textu u tlačítek stránky.

uiAlign může být jedna z následujících hodnot:

Konstanta	Význam
TA_LEFT	Zarovnání doleva
TA_CENTER	Zarovnání na střed
TA_RIGHT	Zarovnání doprava

Výchozí hodnota je TA_CENTER.

CMFCOutlookBarTabCtrl::SetToolbarImageList

Nastaví rastrový obrázek, který obsahuje ikony zobrazené v dolní části panelu Outlooku v režimu Outlooku 2003.

BOOL SetToolbarImageList(
    UINT uiID,
    int cx,
    COLORREF clrTransp=RGB(255, 0, 255));

Parametry

UIID
[v] Určuje ID prostředku image, která se má načíst.

cx
[v] Určuje šířku obrázku v seznamu obrázků v pixelech.

clrTransp
[v] Hodnota RGB, která určuje průhlednou barvu.

Návratová hodnota

Vrátí hodnotu PRAVDA, pokud je úspěšná; v opačném případě vrátí hodnotu FALSE.

Poznámky

Pomocí této funkce můžete připojit seznam obrázků, jehož obrázky se zobrazí na tlačítkách panelu nástrojů v režimu systém Microsoft Office 2003. Indexy obrázků by měly odpovídat indexům stránek.

Tato metoda by neměla být volána, pokud není v režimu systém Microsoft Office 2003. Další informace naleznete v tématu CMFCOutlookBar Třída.

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

void SetVisiblePageButtons(int nVisiblePageButtons);

Parametry

[v] nVisiblePageButtons

Poznámky

Viz také

Graf hierarchie
Třídy
CMFCBaseTabCtrl – třída
CMFCOutlookBar – třída
CMFCOutlookBarPane – třída