CMFCOutlookBarTabCtrl 類別
具有 Microsoft Outlook [ 巡覽窗格 ] 視覺外觀的索引標籤控制項。 如需詳細資訊，請參閱 Visual Studio 安裝的 VC\atlmfc\src\mfc 資料夾中的原始程式碼 。
語法
class CMFCOutlookBarTabCtrl : public CMFCBaseTabCtrl
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
CMFCOutlookBarTabCtrl::CMFCOutlookBarTabCtrl |
預設建構函式。 |
CMFCOutlookBarTabCtrl::~CMFCOutlookBarTabCtrl |
解構函式。 |
公用方法
| 名稱 | 描述 |
|---|---|
| CMFCOutlookBarTabCtrl：：AddControl | 將 Windows 控制項新增為 Outlook 列中的新索引標籤。 |
CMFCOutlookBarTabCtrl::CalcRectEdit |
由架構呼叫，以判斷使用者重新命名索引標籤時所出現的編輯方塊維度。（覆寫 CMFCBaseTabCtrl::CalcRectEdit 。） |
| CMFCOutlookBarTabCtrl：：CanShowFewerPageButtons | 調整作業期間由架構呼叫，以判斷是否可以顯示少於目前可見的 Outlook 列索引標籤頁面按鈕。 |
| CMFCOutlookBarTabCtrl：：CanShowMorePageButtons | 調整作業期間由架構呼叫，以判斷是否可以顯示更多 Outlook 列索引標籤頁面按鈕，而不是目前可見。 |
| CMFCOutlookBarTabCtrl：：Create | 建立 Outlook 列索引標籤控制項。 |
CMFCOutlookBarTabCtrl::CreateObject |
由建立此類別類型的動態執行個體架構所使用。 |
| CMFCOutlookBarTabCtrl：：EnableAnimation | 指定是否啟用作用中索引標籤之間切換期間發生的動畫。 |
| CMFCOutlookBarTabCtrl：：EnableInPlaceEdit | 指定使用者是否可以在 Outlook 列的索引標籤按鈕上修改文字標籤。 （覆寫 CMFCBaseTabCtrl：：EnableInPlaceEdit .） |
| CMFCOutlookBarTabCtrl：：EnableScrollButtons | 由架構呼叫，以啟用按鈕，讓使用者在 Outlook 列窗格上捲動按鈕。 |
CMFCOutlookBarTabCtrl::FindTargetWnd |
識別包含指定點的窗格。 （覆寫 CMFCBaseTabCtrl：：FindTargetWnd .） |
| CMFCOutlookBarTabCtrl：：GetBorderSize | 傳回 Outlook 索引標籤控制項的框線大小。 |
CMFCOutlookBarTabCtrl::GetTabArea |
擷取索引標籤控制項索引標籤區域的大小和位置。 （覆寫 CMFCBaseTabCtrl：：GetTabArea .） |
CMFCOutlookBarTabCtrl::GetThisClass |
由架構用來取得與這個類別類型相關聯之 CRuntimeClass 物件的指標。 |
| CMFCOutlookBarTabCtrl：：GetVisiblePageButtons | |
| CMFCOutlookBarTabCtrl：：IsAnimation | 判斷是否啟用作用中索引標籤之間切換期間發生的動畫。 |
| CMFCOutlookBarTabCtrl：：IsMode2003 | 判斷 Outlook 列索引標籤控制項是否處於模擬 Microsoft Outlook 2003 的模式。 |
CMFCOutlookBarTabCtrl::IsPtInTabArea |
判中斷點是否在索引標籤區域內。 （覆寫 CMFCBaseTabCtrl：：IsPtInTabArea .） |
CMFCOutlookBarTabCtrl::IsTabDetachable |
判斷索引標籤是否可卸離。 （覆寫 CMFCBaseTabCtrl：：IsTabDetachable .） |
CMFCOutlookBarTabCtrl::OnChangeTabs |
插入或移除索引標籤時，由架構呼叫。 (覆寫 CMFCBaseTabCtrl::OnChangeTabs。) |
| CMFCOutlookBarTabCtrl：：OnShowFewerPageButtons | 由架構呼叫，以減少可見的索引標籤頁按鈕數目。 |
| CMFCOutlookBarTabCtrl：：OnShowMorePageButtons | 由架構呼叫，以增加可見的索引標籤頁按鈕數目。 |
| CMFCOutlookBarTabCtrl：：OnShowOptions | 顯示 [ 功能窗格選項 ] 對話方塊。 |
CMFCOutlookBarTabCtrl::RecalcLayout |
重新計算索引標籤控制項的內部配置。 （覆寫 CMFCBaseTabCtrl：：RecalcLayout .） |
| CMFCOutlookBarTabCtrl：：SetActiveTab | 設定使用中的索引標籤。（覆寫 CMFCBaseTabCtrl：：SetActiveTab .） |
| CMFCOutlookBarTabCtrl：：SetBorderSize | 設定 Outlook 索引標籤控制項的框線大小。 |
| CMFCOutlookBarTabCtrl：：SetPageButtonTextAlign | 設定 Outlook 列索引標籤上索引標籤的對齊方式。 |
| CMFCOutlookBarTabCtrl：：SetToolbarImageList | 設定點陣圖，其中包含 Outlook 2003 模式 Outlook 列底部顯示的圖示（請參閱 CMFCOutlookBar 類別 ）。 |
| CMFCOutlookBarTabCtrl：：SetVisiblePageButtons |
備註
若要建立具有停駐支援的 Outlook 列，請使用 CMFCOutlookBar 物件來裝載 Outlook 列索引標籤控制項。 如需詳細資訊，請參閱 CMFCOutlookBar 類別 。
範例
下列範例示範如何初始化 CMFCOutlookBarTabCtrl 物件，並在 類別中使用 CMFCOutlookBarTabCtrl 各種方法。 此範例示範如何在 Outlook 列的索引標籤頁面上啟用文字標籤就地編輯、啟用動畫、啟用捲動控點，讓使用者在 Outlook 列窗格上捲動按鈕、設定 Outlook 索引標籤控制項的框線大小，以及在 Outlook 列的索引標籤按鈕上設定文字標籤的對齊方式。 此程式碼片段是 Outlook 示範範例 的 一部分。
// CMFCOutlookBar& bar
CMFCOutlookBarTabCtrl *pOutlookBar = (CMFCOutlookBarTabCtrl*)bar.GetUnderlyingWindow();
pOutlookBar->EnableInPlaceEdit(TRUE);
pOutlookBar->EnableAnimation();
pOutlookBar->EnableScrollButtons();
pOutlookBar->SetBorderSize(10);
pOutlookBar->SetPageButtonTextAlign(TA_LEFT);
繼承階層架構
需求
標頭： afxoutlookbartabctrl.h
CMFCOutlookBarTabCtrl：：AddControl
將 Windows 控制項新增為 Outlook 列中的新索引標籤。
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);
參數
pWndCtrl
[in]要加入之控制項的指標。
lpszName
[in]指定索引標籤的名稱。
bDetachable
[in]如果為 TRUE，則會將頁面建立為可卸離。
nImageID
[in]要顯示在新索引標籤中之影像的內部影像清單中的影像索引。
dwControlBarStyle
[in]指定包裝停駐窗格的AFX_ CBRS_* 樣式。
備註
使用此函式將控制項新增為 Outlook 列的新頁面。
此函式會在內部呼叫 CMFCBaseTabCtrl：：AddTab 。
如果您將 bDetachable 設定 為 TRUE， AddControl 請在內部建立 CDockablePaneAdapter 物件並包裝新增的控制項。 它會自動將索引標籤視窗的執行時間類別設定為 的 CMFCOutlookBar 執行時間類別，並將浮動框架的執行時間類別設定為 CMultiPaneFrameWnd 。
範例
下列範例示範如何在 類別中使用 AddControlCMFCOutlookBarTabCtrl 方法。 此程式碼片段是 Outlook 示範範例 的 一部分。
// 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
在調整大小作業期間由架構呼叫，以判斷是否可以顯示比目前可見的要少的 Outlook 列索引標籤頁面按鈕。
virtual BOOL CanShowFewerPageButtons() const;
傳回值
如果有多個按鈕，則為 TRUE;否則為 FALSE。
備註
Outlook 列索引標籤控制項會根據可用的空間量，動態新增或移除顯示器中的索引標籤。 架構會使用此方法來協助該程式。
CMFCOutlookBarTabCtrl：：CanShowMorePageButtons
在調整大小作業期間由架構呼叫，以判斷是否可以顯示更多 Outlook 列索引標籤頁面按鈕，而不是目前可見。
virtual BOOL CanShowMorePageButtons() const;
傳回值
如果目前看不到按鈕，則為 TRUE;否則為 FALSE。
備註
Outlook 列索引標籤控制項會根據可用的空間量，動態新增或移除顯示器中的索引標籤。 架構會使用此方法來協助該程式。
CMFCOutlookBarTabCtrl：：Create
建立 Outlook 列索引標籤控制項。
virtual BOOL Create(
const CRect& rect,
CWnd* pParentWnd,
UINT nID);
參數
矩形
[in]指定初始大小和位置，以圖元為單位。
pParentWnd
[in]指向父視窗。 不得為 Null。
nID
[in]控制項識別碼。
傳回值
如果控制項已成功建立，則為非零;否則為 0。
備註
通常，當 CMFCOutlookBar 類別 控制程式的WM_CREATE訊息時 ，就會建立 outlook 列索引標籤控制項。
CMFCOutlookBarTabCtrl：：EnableAnimation
指定是否啟用作用中索引標籤之間切換期間發生的動畫。
static void EnableAnimation(BOOL bEnable=TRUE);
參數
bEnable
[in]指定是否應該啟用或停用動畫。
備註
呼叫此函式以啟用和停用動畫。 當使用者開啟索引標籤頁面時，如果啟用動畫，頁面的標題會向上或向下滑動。 如果停用動畫，頁面會立即變成使用中。
根據預設，會啟用動畫。
CMFCOutlookBarTabCtrl：：EnableInPlaceEdit
指定使用者是否可以修改 Outlook 列的索引標籤頁面按鈕上的文字標籤。
virtual void EnableInPlaceEdit(BOOL bEnable);
參數
bEnable
如果為 TRUE，請啟用文字標籤的就地編輯。 如果為 FALSE，請停用就地編輯。
備註
呼叫此函式，以在索引標籤頁面按鈕上啟用或停用文字標籤的就地編輯。 預設會停用就地編輯。
CMFCOutlookBarTabCtrl：：EnableScrollButtons
由架構呼叫，以啟用捲動控制碼，讓使用者在 Outlook 列窗格上捲動按鈕。
void EnableScrollButtons(
BOOL bEnable = TRUE,
BOOL bIsUp = TRUE,
BOOL bIsDown = TRUE);
參數
bEnable
[in]判斷是否顯示捲動按鈕。
bIsUp
[in]判斷上方捲軸是否顯示。
bIsDown
[in]判斷是否顯示底部捲軸。
備註
啟用捲動按鈕的顯示。 當使用中索引標籤變更以還原捲動按鈕時，架構會呼叫此方法。
CMFCOutlookBarTabCtrl：：GetBorderSize
傳回 Outlook 索引標籤控制項的框線大小。
int GetBorderSize() const;
傳回值
框線大小，以圖元為單位。
CMFCOutlookBarTabCtrl：：GetVisiblePageButtons
int GetVisiblePageButtons() const;
傳回值
備註
CMFCOutlookBarTabCtrl：：IsAnimation
指定是否啟用作用中索引標籤之間切換期間發生的動畫。
static BOOL IsAnimation();
傳回值
如果啟用動畫，則為非零;否則為 0。
備註
呼叫 CMFCOutlookBarTabCtrl：：EnableAnimation 函式來啟用或停用動畫。
CMFCOutlookBarTabCtrl：：IsMode2003
判斷 Outlook 列索引標籤控制項是否處於模擬 Microsoft Outlook 2003 的模式。
BOOL IsMode2003() const;
傳回值
如果 Outlook 列索引標籤控制項處於 Outlook 2003 模式，則為 TRUE;否則為 FALSE;
備註
這個值是由 CMFCOutlookBar：：SetMode2003 所設定。
CMFCOutlookBarTabCtrl：：OnShowFewerPageButtons
由架構呼叫，以減少可見的索引標籤頁按鈕數目。
virtual void OnShowFewerPageButtons();
備註
這個方法會調整控制項調整大小時的顯示頁面索引標籤按鈕數目。
CMFCOutlookBarTabCtrl：：OnShowMorePageButtons
由架構呼叫，以增加可見的索引標籤頁按鈕數目。
virtual void OnShowMorePageButtons();
備註
這個方法會調整控制項調整大小時可見的索引標籤頁按鈕數目。
CMFCOutlookBarTabCtrl：：OnShowOptions
顯示 [ 功能窗格選項 ] 對話方塊。
virtual void OnShowOptions();
備註
[ 功能窗格選項 ] 對話方塊可讓使用者選取要顯示的索引標籤頁面按鈕，以及顯示它們的順序。
當使用者從控制項的自訂功能表選取 功能窗格選項 功能表項目時，架構會呼叫此方法。
CMFCOutlookBarTabCtrl：：SetActiveTab
設定使用中的索引標籤。使用中索引標籤是開啟的索引標籤，其內容會顯示。
virtual BOOL SetActiveTab(int iTab);
參數
iTab
[in]要開啟之索引標籤之以零起始的索引。
傳回值
如果已成功開啟指定的索引標籤，則為非零;否則為 0。
備註
設定使用中索引標籤的視覺效果取決於您是否已啟用動畫。 如需詳細資訊，請參閱 CMFCOutlookBarTabCtrl：：EnableAnimation 。
CMFCOutlookBarTabCtrl：：SetBorderSize
設定 Outlook 索引標籤控制項的框線大小。
void SetBorderSize(int nBorderSize);
參數
nBorderSize
[in]指定以圖元為單位的新框線大小。
備註
設定新的框線大小，並重新計算 Outlook 視窗版面配置。
CMFCOutlookBarTabCtrl：：SetPageButtonTextAlign
設定 Outlook 列索引標籤上索引標籤的對齊方式。
void SetPageButtonTextAlign(
UINT uiAlign,
BOOL bRedraw=TRUE);
參數
uiAlign
[in]指定文字對齊方式。
bRedraw
[in]如果為 TRUE，則會重新繪製 Outlook 視窗。
備註
使用此函式來變更頁面按鈕的文字對齊方式。
uiAlign 可以是下列其中一個值：
| 持續性 | 意義 |
|---|---|
| TA_LEFT | 靠左對齊 |
| TA_CENTER | 置中對齊 |
| TA_RIGHT | 靠右對齊 |
預設值為 TA_CENTER。
CMFCOutlookBarTabCtrl：：SetToolbarImageList
設定點陣圖，其中包含 Outlook 2003 模式 Outlook 列底部顯示的圖示。
BOOL SetToolbarImageList(
UINT uiID,
int cx,
COLORREF clrTransp=RGB(255, 0, 255));
參數
uiID
[in]指定要載入之映射的資源識別碼。
殘雪
[in]指定影像清單中的影像寬度，以圖元為單位。
clrTransp
[in]指定透明色彩的 RGB 值。
傳回值
如果成功，則傳回 TRUE;否則會傳回 FALSE。
備註
使用此函式附加影像清單，其影像將在 Microsoft Office 2003 模式的工具列按鈕上顯示。 影像索引應對應至頁面索引。
如果不是在 Microsoft Office 2003 模式中，則不應該呼叫這個方法。 如需詳細資訊，請參閱 CMFCOutlookBar 類別 。
CMFCOutlookBarTabCtrl：：SetVisiblePageButtons
void SetVisiblePageButtons(int nVisiblePageButtons);
參數
[in] nVisiblePageButtons
備註
另請參閱
階層架構圖表
類別
CMFCBaseTabCtrl 類別
CMFCOutlookBar 類別
CMFCOutlookBarPane 類別
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應