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


CMFCOutlookBarTabCtrl osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Egy tabulátor vezérlőelem, amely a Navigációs ablak vizualizációját jeleníti meg a Microsoft Outlookban. További részletekért tekintse meg a Visual Studio-telepítés VC\atlmfc\src\mfc mappájában található forráskódot.

Szemantika

class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl

Tagok

Nyilvános konstruktorok

Név Description
CMFCOutlookBarTabCtrl::CMFCOutlookBarTabCtrl Alapértelmezett konstruktor.
CMFCOutlookBarTabCtrl::~CMFCOutlookBarTabCtrl Destruktor.

Nyilvános metódusok

Név Description
CMFCOutlookBarTabCtrl::AddControl Új lapként hozzáad egy Windows-vezérlőt az Outlook sávhoz.
CMFCOutlookBarTabCtrl::CalcRectEdit A keretrendszer meghívta a lap átnevezésekor megjelenő szerkesztési mező dimenzióit. (Felülbírálások CMFCBaseTabCtrl::CalcRectEdit.)
CMFCOutlookBarTabCtrl::CanShowFewerPageButtons A keretrendszer meghívta az átméretezési műveletek során annak megállapítására, hogy kevesebb Outlook-sáv lapfül gombja jelenik-e meg, mint amennyi jelenleg látható.
CMFCOutlookBarTabCtrl::CanShowMorePageButtons A keretrendszer meghívta az átméretezési műveletek során annak megállapítására, hogy az Outlook sáv lapfülének több gombja jelenik-e meg, mint amennyi jelenleg látható.
CMFCOutlookBarTabCtrl::Létrehozás Létrehozza az Outlook sávfül vezérlőelemét.
CMFCOutlookBarTabCtrl::CreateObject A keretrendszer egy ilyen típusú dinamikus példány létrehozásához használja.
CMFCOutlookBarTabCtrl::EnableAnimation Megadja, hogy engedélyezve van-e az aktív lapok közötti váltás során megjelenő animáció.
CMFCOutlookBarTabCtrl::EnableInPlaceEdit Megadja, hogy egy felhasználó módosíthatja-e a szövegfeliratokat az Outlook sáv tabulátorgombjaiban. (Felülbírálja a CMFCBaseTabCtrl::EnableInPlaceEdit.)
CMFCOutlookBarTabCtrl::EnableScrollButtons A keretrendszer meghívta, hogy engedélyezze azokat a gombokat, amelyek lehetővé teszik, hogy a felhasználó végiggörgetjen a gombokon az Outlook sáv ablaktábláján.
CMFCOutlookBarTabCtrl::FindTargetWnd A megadott pontot tartalmazó panelt azonosítja. (Felülbírálja a CMFCBaseTabCtrl::FindTargetWnd.)
CMFCOutlookBarTabCtrl::GetBorderSize Az Outlook lap vezérlőelem szegélyméretét adja vissza.
CMFCOutlookBarTabCtrl::GetTabArea Lekéri a tabulátor vezérlőelem lapterületének méretét és pozícióját. (Felülbírálja a CMFCBaseTabCtrl::GetTabArea.)
CMFCOutlookBarTabCtrl::GetThisClass A keretrendszer az ehhez az osztálytípushoz társított CRuntimeClass objektumra mutató mutató lekéréséhez használja.
CMFCOutlookBarTabCtrl::GetVisiblePageButtons
CMFCOutlookBarTabCtrl::IsAnimation Meghatározza, hogy engedélyezve van-e az aktív lapok közötti váltás során megjelenő animáció.
CMFCOutlookBarTabCtrl::IsMode2003 Meghatározza, hogy az Outlook sávfül vezérlőeleme olyan módban van-e, amely a Microsoft Outlook 2003-at emulálja.
CMFCOutlookBarTabCtrl::IsPtInTabArea Meghatározza, hogy egy pont a tabulátor területén belül van-e. (Felülbírálja a CMFCBaseTabCtrl::IsPtInTabArea.)
CMFCOutlookBarTabCtrl::IsTabDetachable Meghatározza, hogy egy lap leválasztható-e. (Felülbírálja a CMFCBaseTabCtrl::IsTabDetachable.)
CMFCOutlookBarTabCtrl::OnChangeTabs A keretrendszer meghívja egy lap beszúrásakor vagy eltávolításakor. (Felülbírálások CMFCBaseTabCtrl::OnChangeTabs.)
CMFCOutlookBarTabCtrl::OnShowFewerPageButtons A keretrendszer meghívta a lapfülek látható gombjainak számának csökkentésére.
CMFCOutlookBarTabCtrl::OnShowMorePageButtons A keretrendszer meghívta, hogy növelje a lapfülek látható gombjainak számát.
CMFCOutlookBarTabCtrl::OnShowOptions Megjeleníti a Navigációs ablak beállításai párbeszédpanelt.
CMFCOutlookBarTabCtrl::RecalcLayout Újraszámítja a tabulátorvezérlő belső elrendezését. (Felülbírálja a CMFCBaseTabCtrl::RecalcLayout.)
CMFCOutlookBarTabCtrl::SetActiveTab Beállítja az aktív lapot. (Felülbírálja a CMFCBaseTabCtrl::SetActiveTab.)
CMFCOutlookBarTabCtrl::SetBorderSize Az Outlook lap vezérlőelem szegélyméretének beállítása.
CMFCOutlookBarTabCtrl::SetPageButtonTextAlign Beállítja a szövegfeliratok igazítását az Outlook sáv tabulátorgombjaiban.
CMFCOutlookBarTabCtrl::SetToolbarImageList Beállítja az Outlook sáv alján megjelenő ikonokat tartalmazó bitképet az Outlook 2003 módban (lásd a CMFCOutlookBar osztályt).
CMFCOutlookBarTabCtrl::SetVisiblePageButtons

Megjegyzések

Ha olyan Outlook-sávot szeretne létrehozni, amely támogatja a dokkolást, használjon objektumot CMFCOutlookBar az Outlook sávfül vezérlőelemének üzemeltetéséhez. További információt a CMFCOutlookBar osztályban talál.

Example

Az alábbi példa bemutatja, hogyan inicializálhat egy CMFCOutlookBarTabCtrl objektumot, és hogyan használhat különböző metódusokat az CMFCOutlookBarTabCtrl osztályban. A példa bemutatja, hogyan engedélyezheti a szövegfelirat helyben történő szerkesztését az Outlook sáv lapfülgombjaiban, hogyan engedélyezheti az animációt, hogyan engedélyezheti a görgetőfogópontokat, amelyek lehetővé teszik a felhasználó számára, hogy végiggörgetjen a gombokon az Outlook sáv ablaktábláján, hogyan állíthatja be az Outlook lap vezérlőelem szegélyméretét, és hogyan állíthatja be a szövegfeliratok igazítását az Outlook sáv tabulátorgombjaiban. Ez a kódrészlet az Outlook Demo-minta része.

// CMFCOutlookBar& bar
CMFCOutlookBarTabCtrl *pOutlookBar = (CMFCOutlookBarTabCtrl*)bar.GetUnderlyingWindow();
pOutlookBar->EnableInPlaceEdit(TRUE);
pOutlookBar->EnableAnimation();
pOutlookBar->EnableScrollButtons();
pOutlookBar->SetBorderSize(10);
pOutlookBar->SetPageButtonTextAlign(TA_LEFT);

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CMFCBaseTabCtrl

CMFCOutlookBarTabCtrl

Requirements

Fejléc: afxoutlookbartabctrl.h

CMFCOutlookBarTabCtrl::AddControl

Új lapként hozzáad egy Windows-vezérlőt az Outlook sávhoz.

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);

Paraméterek

pWndCtrl
[in] A hozzáadni kívánt vezérlőelemre mutató mutató.

lpszName
[in] A lap nevét adja meg.

bDetachable
[in] Ha IGAZ, a lap leválaszthatóként lesz létrehozva.

nImageID
[in] Az új lapon megjelenítendő kép belső képlistájában lévő képindex.

dwControlBarStyle
[in] A becsomagolt dokkolópanelek AFX_ CBRS_* stílusát adja meg.

Megjegyzések

Ezzel a függvénnyel hozzáadhat egy vezérlőt egy outlooksáv új lapjaként.

Ez a függvény belsőleg meghívja a CMFCBaseTabCtrl::AddTab parancsot.

Ha igaz értékre állítja a bDetachable értéket, belsőleg létrehoz egy CDockablePaneAdapter objektumot, AddControl és körbefuttatja a hozzáadott vezérlőt. Automatikusan beállítja a lapozott ablak futtatókörnyezeti osztályát a lebegő keret futtatókörnyezeti osztályára CMFCOutlookBar , a lebegő keret futtatókörnyezet osztályát pedig a következőre CMultiPaneFrameWnd.

Example

Az alábbi példa bemutatja, hogyan használható a AddControl metódus az CMFCOutlookBarTabCtrl osztályban. Ez a kódrészlet az Outlook Demo-minta része.

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

A keretrendszer meghívta az átméretezési műveletek során annak megállapítására, hogy kevesebb Outlook-sáv lapfül gombja jeleníthető-e meg, mint amennyi jelenleg látható.

virtual BOOL CanShowFewerPageButtons() const;

Visszaadott érték

IGAZ, ha egynél több gomb van; egyéb esetben HAMIS.

Megjegyzések

Az Outlook sávfül vezérlője dinamikusan hozzáad vagy eltávolít lapokat a képernyőről attól függően, hogy mennyi hely áll rendelkezésre. A keretrendszer ezt a módszert használja a folyamat segítéséhez.

CMFCOutlookBarTabCtrl::CanShowMorePageButtons

A keretrendszer meghívta az átméretezési műveletek során annak megállapításához, hogy az Outlook sáv lapfülének több gombja jeleníthető-e meg, mint amennyi jelenleg látható.

virtual BOOL CanShowMorePageButtons() const;

Visszaadott érték

IGAZ, ha vannak olyan gombok, amelyek jelenleg nem láthatók; egyéb esetben HAMIS.

Megjegyzések

Az Outlook sávfül vezérlője dinamikusan hozzáad vagy eltávolít lapokat a képernyőről attól függően, hogy mennyi hely áll rendelkezésre. A keretrendszer ezt a módszert használja a folyamat segítéséhez.

CMFCOutlookBarTabCtrl::Létrehozás

Létrehozza az Outlook sávfül vezérlőelemét.

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

Paraméterek

téglalap
[in] Képpontban adja meg a kezdeti méretet és a pozíciót.

pParentWnd
[in] A szülőablakra mutat. Nem lehet NULL értékű.

nID
[in] A vezérlő azonosítója.

Visszaadott érték

Nonzero, ha a vezérlő sikeresen létrejött; egyéb esetben 0.

Megjegyzések

Az Outlook sávfül vezérlői általában akkor jönnek létre, amikor a CMFCOutlookBar osztály vezérli a folyamat WM_CREATE üzenetét.

CMFCOutlookBarTabCtrl::EnableAnimation

Megadja, hogy engedélyezve van-e az aktív lapok közötti váltás során megjelenő animáció.

static void EnableAnimation(BOOL bEnable=TRUE);

Paraméterek

bEnable
[in] Megadja, hogy az animáció engedélyezve vagy letiltva legyen-e.

Megjegyzések

Hívja meg ezt a függvényt az animáció engedélyezéséhez és letiltásához. Amikor a felhasználó megnyit egy lapfület, a lap felirata felfelé vagy lefelé csúszik, ha az animáció engedélyezve van. Ha az animáció le van tiltva, a lap azonnal aktívvá válik.

Alapértelmezés szerint az animáció engedélyezve van.

CMFCOutlookBarTabCtrl::EnableInPlaceEdit

Megadja, hogy egy felhasználó módosíthatja-e a szövegfeliratokat az Outlook sáv lapfülgombjaiban.

virtual void EnableInPlaceEdit(BOOL bEnable);

Paraméterek

bEnable
Ha IGAZ, engedélyezze a szövegfelirat helyben történő szerkesztését. Ha HAMIS, tiltsa le a helyszíni szerkesztést.

Megjegyzések

A függvény meghívásával engedélyezheti vagy letilthatja a szövegfeliratok helyben történő szerkesztését a lapfül gombjaiban. Alapértelmezés szerint a helyszíni szerkesztés le van tiltva.

CMFCOutlookBarTabCtrl::EnableScrollButtons

A keretrendszer meghívta a görgetőfogópontok engedélyezésére, amelyek lehetővé teszik, hogy a felhasználó végiggörgetjen a gombokon az Outlook sáv ablaktábláján.

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

Paraméterek

bEnable
[in] Meghatározza, hogy megjelennek-e a görgetőgombok.

bIsUp
[in] Meghatározza, hogy megjelenik-e a felső görgetősáv.

bIsDown
[in] Meghatározza, hogy megjelenik-e az alsó görgetősáv.

Megjegyzések

Engedélyezi a görgetőgombok megjelenítését. Ezt a metódust a keretrendszer hívja meg, amikor az aktív lap megváltozik a görgetőgombok visszaállításához.

CMFCOutlookBarTabCtrl::GetBorderSize

Az Outlook lap vezérlőelem szegélyméretét adja vissza.

int GetBorderSize() const;

Visszaadott érték

A szegély mérete képpontban.

CMFCOutlookBarTabCtrl::GetVisiblePageButtons

int GetVisiblePageButtons() const;

Visszaadott érték

Megjegyzések

CMFCOutlookBarTabCtrl::IsAnimation

Megadja, hogy engedélyezve van-e az aktív lapok közötti váltás során megjelenő animáció.

static BOOL IsAnimation();

Visszaadott érték

Nonzero, ha az animáció engedélyezve van; egyéb esetben 0.

Megjegyzések

Hívja meg a CMFCOutlookBarTabCtrl::EnableAnimation függvényt az animáció engedélyezéséhez vagy letiltásához.

CMFCOutlookBarTabCtrl::IsMode2003

Meghatározza, hogy az Outlook sávfül vezérlőeleme olyan módban van-e, amely a Microsoft Outlook 2003-at emulálja.

BOOL IsMode2003() const;

Visszaadott érték

IGAZ, ha az Outlook sávfül vezérlőeleme Outlook 2003 módban van; egyéb esetben HAMIS;

Megjegyzések

Ezt az értéket a CMFCOutlookBar::SetMode2003 állítja be.

CMFCOutlookBarTabCtrl::OnShowFewerPageButtons

A keretrendszer meghívta a lapfülek látható gombjainak számának csökkentésére.

virtual void OnShowFewerPageButtons();

Megjegyzések

Ez a módszer a vezérlőelem átméretezésekor módosítja a látható lapfülgombok számát.

CMFCOutlookBarTabCtrl::OnShowMorePageButtons

A keretrendszer meghívta, hogy növelje a lapfülek látható gombjainak számát.

virtual void OnShowMorePageButtons();

Megjegyzések

Ezzel a módszerrel módosíthatja a vezérlőelem átméretezésekor látható lapfülgombok számát.

CMFCOutlookBarTabCtrl::OnShowOptions

Megjeleníti a Navigációs ablak beállításai párbeszédpanelt.

virtual void OnShowOptions();

Megjegyzések

A Navigációs ablak beállításai párbeszédpanelen a felhasználó kiválaszthatja, hogy mely lapgombok jelenjenek meg, és hogy milyen sorrendben jelenjenek meg.

Ezt a metódust a keretrendszer hívja meg, amikor a felhasználó kiválasztja a navigációs ablak beállításai menüelemet a vezérlő testreszabási menüjéből.

CMFCOutlookBarTabCtrl::SetActiveTab

Az aktív lap beállítása. Az aktív lap a megnyitott lap, amelynek tartalma látható.

virtual BOOL SetActiveTab(int iTab);

Paraméterek

iTab
[in] A megnyitni kívánt lap nulla alapú indexe.

Visszaadott érték

Nem kötelező, ha a megadott lap sikeresen meg van nyitva; egyéb esetben 0.

Megjegyzések

Az aktív lap beállításának vizuális hatása attól függ, hogy engedélyezte-e az animációt. További információ: CMFCOutlookBarTabCtrl::EnableAnimation.

CMFCOutlookBarTabCtrl::SetBorderSize

Az Outlook lap vezérlőelem szegélyméretének beállítása.

void SetBorderSize(int nBorderSize);

Paraméterek

nBorderSize
[in] Az új szegélyméretet képpontban adja meg.

Megjegyzések

Beállítja az új szegélyméretet, és újraszámítja az Outlook ablakelrendezését.

CMFCOutlookBarTabCtrl::SetPageButtonTextAlign

Beállítja a szövegfeliratok igazítását az Outlook sáv tabulátorgombjaiban.

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

Paraméterek

uiAlign
[in] A szöveg igazítását adja meg.

bRedraw
[in] Ha IGAZ, az outlook ablaka újra lesz adva.

Megjegyzések

Ezzel a függvénnyel módosíthatja az oldalgombok szöveg igazítását.

Az uiAlign az alábbi értékek egyike lehet:

Állandó Meaning
TA_LEFT Balra igazítás
TA_CENTER Középre igazítás
TA_RIGHT Jobbra igazítás

Az alapértelmezett érték a TA_CENTER.

CMFCOutlookBarTabCtrl::SetToolbarImageList

Beállítja az Outlook sáv alján megjelenő ikonokat tartalmazó bitképet az Outlook 2003 módban.

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

Paraméterek

uiID
[in] Megadja a betöltendő kép erőforrás-azonosítóját.

Cx
[in] Egy kép szélességét adja meg a képlistában képpontban.

clrTransp
[in] Az áttetsző színt meghatározó RGB-érték.

Visszaadott érték

Igaz értéket ad vissza, ha sikeres; ellenkező esetben HAMIS értéket ad vissza.

Megjegyzések

Ezzel a függvénnyel csatolhat egy képlistát, amelynek képei a Microsoft Office 2003 módban jelennek meg az eszköztárgombokon. A képindexeknek meg kell felelnie a lapindexeknek.

Ezt a metódust nem szabad meghívni, ha nem Microsoft Office 2003 módban. További információt a CMFCOutlookBar osztályban talál.

CMFCOutlookBarTabCtrl::SetVisiblePageButtons

void SetVisiblePageButtons(int nVisiblePageButtons);

Paraméterek

[in] nVisiblePageButtons

Megjegyzések

Lásd még

hierarchiadiagram
osztályok
CMFCBaseTabCtrl osztály
CMFCOutlookBar osztály
CMFCOutlookBarPane osztály