CMFCAutoHideButton 類別
可顯示或隱藏 CDockablePane Class (設定為隱藏) 的按鈕。
如需更多詳細資料，請參閱 Visual Studio 安裝位置下之 VC\atlmfc\src\mfc 資料夾中的原始程式碼。
語法
class CMFCAutoHideButton : public CObject
成員
公用方法
| 名稱 | 描述 |
|---|---|
| CMFCAutoHideButton：：BringToTop | |
| CMFCAutoHideButton：：Create | 建立並初始化自動隱藏按鈕。 |
| CMFCAutoHideButton：：GetAlignment | 擷取自動隱藏按鈕的對齊方式。 |
| CMFCAutoHideButton：：GetAutoHideWindow | 會傳 回與自動隱藏按鈕相關聯的 CDockablePane 物件。 |
| CMFCAutoHideButton：：GetParentToolBar | |
| CMFCAutoHideButton：：GetRect | |
| CMFCAutoHideButton：：GetSize | 決定自動隱藏按鈕的大小。 |
| CMFCAutoHideButton：：GetTextSize | 傳回自動隱藏按鈕文字標籤的大小。 |
| CMFCAutoHideButton：：HighlightButton | 反白顯示自動隱藏按鈕。 |
| CMFCAutoHideButton：：IsActive | 指出自動隱藏按鈕是否為作用中。 |
| CMFCAutoHideButton：：IsHighlighted | 傳回自動隱藏按鈕反白顯示的狀態。 |
| CMFCAutoHideButton：：IsHorizontal | 判斷自動隱藏按鈕是水平或垂直。 |
| CMFCAutoHideButton：：IsTop | |
| CMFCAutoHideButton：：IsVisible | 指出是否顯示按鈕。 |
| CMFCAutoHideButton：：Move | |
| CMFCAutoHideButton：：OnDraw | 當它繪製自動隱藏按鈕時，架構會呼叫這個方法。 |
| CMFCAutoHideButton：：OnDrawBorder | 當它繪製自動隱藏按鈕的邊框時，架構會呼叫這個方法。 |
| CMFCAutoHideButton：：OnFillBackground | 當它填入自動隱藏按鈕的背景時，架構會呼叫這個方法。 |
| CMFCAutoHideButton：：ReplacePane | |
| CMFCAutoHideButton：：ShowAttachedWindow | 顯示或隱藏相關聯的 CDockablePane 類別。 |
| CMFCAutoHideButton：：ShowButton | 顯示或隱藏自動隱藏按鈕。 |
| CMFCAutoHideButton：：UnSetAutoHideMode |
備註
建立時， CMFCAutoHideButton 物件會附加至 CDockablePane 類別。 CDockablePane 物件會隨著使用者與 CMFCAutoHideButton 物件的互動隱藏或顯示。
根據預設，當使用者開啟自動隱藏時，架構會自動建立 CMFCAutoHideButton。 架構可以建立自訂 UI 類別而不是 CMFCAutoHideButton 類別的項目。 若要指定架構應該使用的自訂 UI 類別，請將靜態成員變數 CMFCAutoHideBar::m_pAutoHideButtonRTS 設定為等於自訂 UI 類別。 根據預設，此變數會設為 CMFCAutoHideButton。
範例
下列範例示範如何建構 CMFCAutoHideButton 物件，以及使用 CMFCAutoHideButton 類別中的各種方法。 此範例示範如何初始化 CMFCAutoHideButton 物件 (使用其 Create 方法)，顯示相關聯的 CDockablePane 類別，並顯示自動隱藏按鈕。
CMFCAutoHideButton *autoHideButton = new CMFCAutoHideButton();
CDockablePane cPane;
// CMFCAutoHideBar* pParentBar
if (!autoHideButton->Create(pParentBar, &cPane, CBRS_ALIGN_LEFT))
{
return 0;
}
autoHideButton->ShowAttachedWindow(true);
autoHideButton->ShowButton(true);
繼承階層架構
CMFCAutoHideButton
需求
標頭： afxautohidebutton.h
CMFCAutoHideButton：：BringToTop
void BringToTop();
備註
CMFCAutoHideButton：：Create
建立並初始化自動隱藏按鈕。
virtual BOOL Create(
CMFCAutoHideBar* pParentBar,
CDockablePane* pAutoHideWnd,
DWORD dwAlignment);
參數
pParentBar
[in]父工具列的指標。
pAutoHideWnd
[in]CDockablePane 物件的指標。 這個自動隱藏按鈕會隱藏並顯示 。CDockablePane
dwAlignment
[in]值，指定按鈕與主框架視窗的對齊方式。
傳回值
如果成功則為非零；否則為 0。
備註
當您建立 CMFCAutoHideButton 物件時，必須將自動隱藏按鈕與特定 CDockablePane產生關聯。 使用者可以使用自動隱藏按鈕來隱藏並顯示相關聯的 CDockablePane。
dwAlignment 參數會指出自動隱藏按鈕位於應用程式中的位置。 這個參數可以是下列任何一個值：
CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM
CMFCAutoHideButton：：GetAlignment
擷取自動隱藏按鈕的對齊方式。
DWORD GetAlignment() const;
傳回值
DWORD 值，其中包含自動隱藏按鈕的目前對齊方式。
備註
自動隱藏按鈕的對齊方式表示按鈕位於應用程式上的位置。 它可以是下列任何一個值：
CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CRBS_ALIGN_TOP
CBRS_ALIGN_BOTTOM
CMFCAutoHideButton：：GetAutoHideWindow
會傳 回與自動隱藏按鈕相關聯的 CDockablePane 物件。
CDockablePane* GetAutoHideWindow() const;
傳回值
相關聯 CDockablePane 物件的指標。
備註
若要將自動隱藏按鈕與 CDockablePane產生關聯，請將 當做參數傳遞 CDockablePane 至 CMFCAutoHideButton：：Create 方法。
CMFCAutoHideButton：：GetParentToolBar
CMFCAutoHideBar* GetParentToolBar();
傳回值
備註
CMFCAutoHideButton：：GetRect
CRect GetRect() const;
傳回值
備註
CMFCAutoHideButton：：GetSize
決定自動隱藏按鈕的大小。
CSize GetSize() const;
傳回值
CSize物件，包含按鈕大小。
備註
計算的大小包含自動隱藏按鈕的框線大小。
CMFCAutoHideButton：：GetTextSize
傳回自動隱藏按鈕文字標籤的大小。
virtual CSize GetTextSize() const;
傳回值
CSize 物件，其中包含自動隱藏按鈕的文字大小。
CMFCAutoHideButton：：IsActive
指出自動隱藏按鈕是否為作用中。
BOOL IsActive() const;
傳回值
如果自動隱藏按鈕為作用中，則為TRUE;否則為 FALSE。
備註
顯示相關聯的 CDockablePane [類別 ] 視窗時，會自動隱藏按鈕作用中。
CMFCAutoHideButton：：IsHorizontal
判斷自動隱藏按鈕是水平或垂直。
BOOL IsHorizontal() const;
傳回值
如果按鈕為水準，則為非零;否則為 0。
備註
架構會在建立 CMFCAutoHideButton 物件時設定方向。 您可以使用 CMFCAutoHideButton：：Create 方法中的 dwAlignment 參數來控制方向。
CMFCAutoHideButton：：IsTop
BOOL IsTop() const;
傳回值
備註
CMFCAutoHideButton：：IsVisible
指出是否顯示自動隱藏按鈕。
virtual BOOL IsVisible() const;
傳回值
如果按鈕可見，則為TRUE;否則為 FALSE。
CMFCAutoHideButton：：OnDraw
當它繪製自動隱藏按鈕時，架構會呼叫這個方法。
virtual void OnDraw(CDC* pDC);
參數
pDC
[in]裝置內容的指標。
備註
如果您想要自定義應用程式中自動隱藏按鈕的外觀，請建立衍生自 CMFCAutoHideButton的新類別。 在您的衍生類別中，覆寫這個方法。
CMFCAutoHideButton：：OnDrawBorder
當它繪製自動隱藏按鈕的邊框時，架構會呼叫這個方法。
virtual void OnDrawBorder(
CDC* pDC,
CRect rectBounds,
CRect rectBorderSize);
參數
pDC
[in]裝置內容的指標。
rectBounds
[in]自動隱藏按鈕的周框。
rectBorderSize
[in]自動隱藏按鈕每一側的框線粗細。
備註
如果您想要自定義應用程式中每個自動隱藏按鈕的框線，請建立衍生自 CMFCAutoHideButton的新類別。 在您的衍生類別中，覆寫這個方法。
CMFCAutoHideButton：：OnFillBackground
當它填入自動隱藏按鈕的背景時，架構會呼叫這個方法。
virtual void OnFillBackground(
CDC* pDC,
CRect rect);
參數
pDC
[in]裝置內容的指標。
rect
[in]自動隱藏按鈕的周框。
備註
如果您想要自定義應用程式中自動隱藏按鈕的背景，請建立衍生自 CMFCAutoHideButton的新類別。 在您的衍生類別中，覆寫這個方法。
CMFCAutoHideButton：：ShowAttachedWindow
顯示或隱藏相關聯的 CDockablePane 類別。
void ShowAttachedWindow(BOOL bShow);
參數
bShow
[in]布林值，指定這個方法是否顯示附加 CDockablePane的 。
CMFCAutoHideButton：：ShowButton
顯示或隱藏自動隱藏按鈕。
virtual void ShowButton(BOOL bShow);
參數
bShow
[in]布爾值，指定是否要顯示自動隱藏按鈕。
CMFCAutoHideButton：：Move
void Move(int nOffset);
參數
[in] nOffset
備註
CMFCAutoHideButton：：ReplacePane
void ReplacePane(CDockablePane* pNewBar);
參數
[in] pNewBar
備註
CMFCAutoHideButton：：UnSetAutoHideMode
停用自動隱藏模式。
virtual void UnSetAutoHideMode(CDockablePane* pFirstBarInGroup);
參數
pFirstBarInGroup
[in]群組中第一個列的指標。
備註
CMFCAutoHideButton：：HighlightButton
醒目提示自動隱藏按鈕。
virtual void HighlightButton(BOOL bHighlight);
參數
bHighlight
指定新的自動隱藏按鈕狀態。 TRUE 表示按鈕已反白顯示，FALSE 表示不會反白顯示按鈕。
備註
CMFCAutoHideButton：：IsHighlighted
傳回自動隱藏按鈕的醒目提示狀態。
virtual BOOL IsHighlighted() const;
傳回值
如果反白顯示自動隱藏按鈕，則會傳回 TRUE;否則為 FALSE。