CMFCToolBarButton 類別

發行項
02/28/2013

提供按鈕功能讓工具列。

class CMFCToolBarButton : public CObject

Members

公用建構函式

名稱	描述
CMFCToolBarButton::CMFCToolBarButton	建構和 CMFCToolBarButton 初始化物件。
CMFCToolBarButton::~CMFCToolBarButton	解構函式。

公用方法

名稱	描述
CMFCToolBarButton::CanBeDropped	指定使用者是否可以放置在工具列按鈕或功能表在自訂中。
CMFCToolBarButton::CanBeStored	指定是否可儲存按鈕。
CMFCToolBarButton::CanBeStretched	指定使用者是否可以在自訂中自動縮放的按鈕。
CMFCToolBarButton::CompareWith	這個執行個體與提供的物件相比較。 CMFCToolBarButton
CMFCToolBarButton::CopyFrom	複製到另一個工具列按鈕的屬性設定為目前的按鈕。
CMFCToolBarButton::CreateFromOleData	若要從提供的 COleDataObject 物件的 CMFCToolBarButton 物件。
CMFCToolBarButton::CreateObject	由架構建立這個類別型別的動態執行個體。
CMFCToolBarButton::EnableWindow	啟用或停用滑鼠和鍵盤輸入。
CMFCToolBarButton::ExportToMenuButton	複製的工具列按鈕上的文字加入至功能表。
CMFCToolBarButton::GetClipboardFormat	擷取應用程式的全域剪貼簿格式。
CMFCToolBarButton::GetHwnd	擷取與工具列按鈕的視窗控制代碼。
CMFCToolBarButton::GetImage	擷取按鈕的影像索引。
CMFCToolBarButton::GetInvalidateRect	擷取按鈕的工作區的本機必須重繪。
CMFCToolBarButton::GetParentWnd	擷取按鈕的父視窗。
CMFCToolBarButton::GetProtectedCommands	擷取使用者無法自訂命令的清單。
CMFCToolBarButton::GetTextSize	擷取按鈕文字的大小。
CMFCToolBarButton::HasFocus	判斷按鈕目前是否具有輸入焦點。
CMFCToolBarButton::HaveHotBorder	確定按鈕的框線是否顯示，當使用者選取按鈕。
CMFCToolBarButton::IsDrawImage	判斷影像是否顯示在按鈕上。
CMFCToolBarButton::IsDrawText	判斷文字標籤是顯示在按鈕上。
CMFCToolBarButton::IsDroppedDown	判斷按鈕是否顯示子功能表。
CMFCToolBarButton::IsEditable	判斷按鈕是否可以自訂。
CMFCToolBarButton::IsExtraSize	判斷按鈕是否可以顯示具有擴充的框線。
CMFCToolBarButton::IsFirstInGroup	判斷按鈕是否在第一個位置在其按鈕群組中。
CMFCToolBarButton::IsHidden	判斷按鈕是否隱藏。
CMFCToolBarButton::IsHorizontal	判斷按鈕是否位於一個層級的工具列。
CMFCToolBarButton::IsLastInGroup	指定按鈕是否在最後一個位置在其按鈕群組中。
CMFCToolBarButton::IsLocked	判斷按鈕是否已鎖定 (不可自訂的工具列)。
CMFCToolBarButton::IsOwnerOf	判斷按鈕是否為所提供的視窗控制代碼的擁有人。
CMFCToolBarButton::IsVisible	決定工具列按鈕是否為可見。
CMFCToolBarButton::IsWindowVisible	決定按鈕的基礎視窗控制代碼是否為可見。
CMFCToolBarButton::NotifyCommand	指定按鈕是否處理 WM_COMMAND 訊息。
CMFCToolBarButton::OnAddToCustomizePage	呼叫框架，該按鈕會加入 [自訂] 對話方塊。
CMFCToolBarButton::OnBeforeDrag	指定按鈕是否可以拖曳。
CMFCToolBarButton::OnBeforeDrop	指定使用者是否可以置放目標工具列上的按鈕。
CMFCToolBarButton::OnCalculateSize	呼叫框架計算按鈕的大小指定的裝置內容和停駐狀態的。
CMFCToolBarButton::OnCancelMode	呼叫由架構處理 WM_CANCELMODE 訊息。
CMFCToolBarButton::OnChangeParentWnd	呼叫框架，在按一下插入新的工具列。
CMFCToolBarButton::OnClick	呼叫框架，當使用者按一下滑鼠按鈕。
CMFCToolBarButton::OnClickUp	呼叫框架，使用者放開滑鼠按鈕。
CMFCToolBarButton::OnContextHelp	呼叫框架，其在父代 (Parent) 工具列處理 WM_HELPHITTEST 訊息。
CMFCToolBarButton::OnCtlColor	呼叫框架，其在父代 (Parent) 工具列處理 WM_CTLCOLOR 訊息。
CMFCToolBarButton::OnCustomizeMenu	當應用程式會在父代 (Parent) 工具列時，就會使用捷徑功能表可以讓按鈕修改所提供的功能表。
CMFCToolBarButton::OnDblClk	呼叫框架，其在父代 (Parent) 工具列處理 WM_LBUTTONDBLCLK 訊息。
CMFCToolBarButton::OnDraw	使用指定的樣式和選項，會由架構來繪製按鈕。
CMFCToolBarButton::OnDrawOnCustomizeList	呼叫框架會在 [自訂] 對話方塊的 [命令] 窗格的按鈕。
CMFCToolBarButton::OnGetCustomToolTipText	呼叫由架構擷取按鈕的自訂工具提示文字。
CMFCToolBarButton::OnGlobalFontsChanged	呼叫框架，其在全域已經變更。
CMFCToolBarButton::OnMove	呼叫框架，其在父代 (Parent) 工具列移動。
CMFCToolBarButton::OnShow	呼叫框架，該按鈕會變成可見或不可見的。
CMFCToolBarButton::OnSize	呼叫，便會由架構父代 (Parent) 工具列變更時的大小或位置和這個變更要求按鈕得以變更大小。
CMFCToolBarButton::OnToolHitTest	呼叫框架，其在父代 (Parent) 工具列必須判斷某個點是否在按鈕的週框 (Bounding Rectangle)。
CMFCToolBarButton::OnUpdateToolTip	呼叫框架，其在父代 (Parent) 工具列更新它的工具提示文字。
CMFCToolBarButton::PrepareDrag	呼叫框架，該按鈕會執行拖放作業。
CMFCToolBarButton::Rect	擷取按鈕的週框 (Bounding Rectangle)。
CMFCToolBarButton::ResetImageToDefault	設定為預設值與按鈕關聯的影像。
CMFCToolBarButton::SaveBarState	將工具列按鈕的狀態。
CMFCToolBarButton::Serialize	從檔案讀取或寫入的這個物件為檔案。 (覆寫 CObject::Serialize)。
CMFCToolBarButton::SetACCData	填入可及性資料所提供的 CAccessibilityData 物件從工具列按鈕。
CMFCToolBarButton::SetClipboardFormatName	指定全域剪貼簿格式。
CMFCToolBarButton::SetImage	將按鈕的影像索引。
CMFCToolBarButton::SetProtectedCommands	設定使用者無法自訂命令的清單。
CMFCToolBarButton::SetRadio	呼叫框架，在按一下變更的核取狀態。
CMFCToolBarButton::SetRect	將按鈕的週框 (Bounding Rectangle)。
CMFCToolBarButton::SetStyle	設定按鈕的樣式。
CMFCToolBarButton::SetVisible	指定按鈕是否為可見。
CMFCToolBarButton::Show	顯示或隱藏按鈕。

資料成員

名稱	描述
CMFCToolBarButton::m_bImage	指定影像是否顯示在按鈕上。
CMFCToolBarButton::m_bText	指定文字標籤是否顯示在按鈕上。
CMFCToolBarButton::m_bTextBelow	指定文字標籤是在按鈕上的影像便會顯示。
CMFCToolBarButton::m_bUserButton	指定按鈕是否有使用者定義的影像。
CMFCToolBarButton::m_bWholeText	指定按鈕是否會顯示出全文標籤，即使不相容的週框 (Bounding Rectangle)。
CMFCToolBarButton::m_bWrap	指定在分隔符號旁邊的按鈕是否在下一個資料列會放置。
CMFCToolBarButton::m_bWrapText	指定多行文字標籤是否已啟用。
CMFCToolBarButton::m_nID	按鈕的命令 ID。
CMFCToolBarButton::m_nStyle	按鈕的樣式。
CMFCToolBarButton::m_strText	按鈕的文字標籤。

備註

CMFCToolbarButton 物件就是位於工具列上的控制項。它的行為類似一般按鈕。您可以將影像和文字標籤加入至物件。工具列按鈕也可以有一個命令 ID。. 當使用者按一下工具列按鈕時，架構會執行這個 ID 指定的命令。

一般來說，工具列按鈕可以自訂:使用者可以從拖曳一個工具列的按鈕加入至另一個、複製、貼上、刪除和編輯文字標籤和影像。若要防止使用者自訂工具列，您可以用兩種方式來鎖定工具列。其中一個設定為 TRUE 的 bLocked 旗標，當您呼叫 CMFCToolBar::LoadToolBar時使用 CMFCToolBarButton::SetProtectedCommands 方法，或將個別按鈕的命令 ID 給受保護命令全域清單。

CMFCToolBarButton 物件從工具列影像的全域集合上顯示影像在應用程式中。這些集合是由父代 (Parent) 工具列， CMFCToolBar 類別維護。如需詳細資訊，請參閱 CMFCToolBarImages 類別。

當使用者按一下工具列按鈕時，它的父代 (Parent) 工具列處理滑鼠訊息和溝通適當行為加入至按鈕。如果按鈕有有效的命令 ID，父代 (Parent) 工具列 WM_COMMAND 資訊傳送至父框架。

CMFCToolBarButton 類別為其他工具列按鈕類別的基底類別，例如、和 CMFCToolBarMenuButton 類別 CMFCToolBarEditBoxButton 類別 CMFCToolBarComboBoxButton 類別。

範例

您可以使用類別，在 CMFCToolBarButton 的各種方法。下列範例將示範如何設定 CMFCToolBarButton 物件。範例會說明如何啟用滑鼠和鍵盤輸入，將按鈕的影像索引，請將按鈕的週框和呈現按鈕為可見。這個程式碼片段是索引標籤控制項範例的一部分。

    CMFCToolBarButton* pOffice2007 = NULL;
    int nIndex = -1;
    
    for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
    {
        // CMFCToolBar  m_wndToolBarTheme
        nIndex = m_wndToolBarTheme.CommandToIndex (uiCmd);

        CMFCToolBarButton* pButton = m_wndToolBarTheme.GetButton (nIndex);
    
        if (pButton != NULL)
        {
            pOffice2007 = pButton;
            break;
        }
    }


...


    pOffice2007->EnableWindow();
    pOffice2007->SetImage(1);
    pOffice2007->SetRect( CRect(1,1,1,1));
    pOffice2007->SetVisible();
    pOffice2007->Show(true);