CMFCButton 類別

發行項
02/28/2013

CMFCButton 類別將功能加入至 CButton 類別 (例如對齊按鈕文字，結合了按鈕文字和影像，選取游標和指定工具提示。

class CMFCButton : public CButton

Members

公用建構函式

名稱	描述
CMFCButton::CMFCButton	預設建構函式。
CMFCButton::~CMFCButton	解構函式。

公用方法

名稱	描述
CMFCButton::CleanUp	重設的內部變數並釋放配置的資源 (例如影像、點陣圖和圖示。
CMFCButton::CreateObject	由架構建立這個類別型別的動態執行個體。
CMFCButton::DrawItem	呼叫框架，只有一個主控描繪 (Owner-Drawn) 按鈕的視覺外觀變更時。 (覆寫 CButton::DrawItem)。
CMFCButton::EnableFullTextTooltip	指定是否顯示為工具提示的文字會以工具提示視窗的或文字的截斷的版本在小型工具提示視窗的。
CMFCButton::EnableMenuFont	指定按鈕文字的字型是否與應用程式功能表字型。
CMFCButton::EnableWindowsTheming	指定按鈕的框線樣式是否符合目前 Windows 佈景主題。
CMFCButton::GetThisClass	由框架以取得指向與這個類別型別的 CRuntimeClass 物件。
CMFCButton::GetToolTipCtrl	傳回基礎工具提示控制項的參考。
CMFCButton::IsAutoCheck	表示核取方塊或選項按鈕是否為自動按鈕。
CMFCButton::IsAutorepeatCommandMode	指出是否設定為自動迴圈。
CMFCButton::IsCheckBox	指出是否為核取方塊按鈕。
CMFCButton::IsChecked	指示目前的按鈕是否已核取。
CMFCButton::IsHighlighted	指出是否已反白顯示。
CMFCButton::IsPressed	指出是否已按下並反白顯示。
CMFCButton::IsPushed	會指示是否已按下按鈕。
CMFCButton::IsRadioButton	指出是否為選項按鈕。
CMFCButton::IsWindowsThemingEnabled	表示按鈕的框線樣式是否符合目前 Windows 佈景主題。
CMFCButton::OnDrawParentBackground	繪製按鈕的父代背景指定區域的。 (覆寫 AFX_GLOBAL_DATA::DrawParentBackground)。
CMFCButton::PreTranslateMessage	包含會分派給 TranslateMessage 和 DispatchMessage Windows 函式之前，將 Windows 訊息。 (覆寫 CWnd::PreTranslateMessage)。
CMFCButton::SetAutorepeatMode	將按鈕自動迴圈。
CMFCButton::SetCheckedImage	設定已選取之按鈕的影像。
CMFCButton::SetFaceColor	設定按鈕文字的背景色彩。
CMFCButton::SetImage	將按鈕的影像。
CMFCButton::SetMouseCursor	設定游標影像。
CMFCButton::SetMouseCursorHand	設定游標相符的影像。
CMFCButton::SetStdImage	使用 CMenuImages 物件設定按鈕影像。
CMFCButton::SetTextColor	設定按鈕文字的色彩不會選取之按鈕的。
CMFCButton::SetTextHotColor	設定按鈕文字的色彩都已選取之按鈕的。
CMFCButton::SetTooltip	與相關聯的工具提示按鈕。
CMFCButton::SizeToContent	調整按鈕大小包含它的按鈕文字和影像。

受保護的方法

名稱	描述
CMFCButton::OnDraw	呼叫由架構來繪製按鈕。
CMFCButton::OnDrawBorder	呼叫由架構分割按鈕的框線。
CMFCButton::OnDrawFocusRect	呼叫框架繪製按鈕的焦點矩形。
CMFCButton::OnDrawText	呼叫框架繪製按鈕文字。
CMFCButton::OnFillBackground	呼叫框架繪製按鈕文字的背景。
CMFCButton::SelectFont	擷取與指定之裝置內容的字型。

資料成員

名稱	描述
CMFCButton::m_bDrawFocus	表示是否要在按鈕四周繪製焦點矩形。
CMFCButton::m_bHighlightChecked	當游標停留在它，是否要反白顯示 BS_CHECKBOX-style 按鈕。
CMFCButton::m_bRightImage	表示是否要在按鈕右邊顯示影像。
CMFCButton::m_bTransparent	指出是否啟用透明。
CMFCButton::m_nAlignStyle	指定按鈕文字的對齊方式。
CMFCButton::m_nFlatStyle	指定按鈕的樣式，例如無框線，平滑，或半水平 3D。

備註

按鈕的其他型別 CMFCButton 從類別衍生，例如 CMFCURLLinkButton 類別，支援超連結和 CMFCColorButton 類別，支援色彩選擇器對話方塊。

CMFCButton 物件的模式可以是 3D，平滑，一般或完全沒有框線。按鈕文字可以靠左，頂端或按鈕的中央。在執行階段，您可以控制按鈕是否顯示文字、影像、文字和影像。您也可以指定特定游標會顯示影像，當游標停留在按鈕時。

建立按鈕控制項直接在您的程式碼，或是使用 [MFC 類別精靈] 工具和對話方塊範本。如果您直接建立按鈕控制項，請將 CMFCButton 變數加入您的應用程式，然後呼叫建構函式，並 CMFCButton 的 Create 方法。如果您使用 [MFC 類別精靈]，請將 CButton 變數加入您的應用程式，然後從 CButton 變更引數的型別轉換為 CMFCButton。

若要處理在對話方塊中應用程式的通知訊息，請加入訊息對應項目和事件處理常式會在每個告知的。 CMFCButton 物件傳送的告知數目相同。 CButton 物件傳送的項目。

範例

您可以使用類別，在 CMFCButton 的各種方法。下列範例將示範如何設定按鈕的屬性。這個範例是新的控制項範例的一部分。

    CMFCButton m_Button;


...


    // int m_iImage
    // IDB_BTN1_32, IDB_BTN1_HOT_32, IDB_BTN1, IDB_BTN1_HOT are int macros that are #define.
    if (m_iImage == 1) 
    {
        m_Button.SetImage((HBITMAP) NULL);
    }
    else
    {
        m_Button.SetImage(IDB_BTN1_32, IDB_BTN1_HOT_32);
    }


...


    // int m_iImage
    if (m_iImage == 0)
    {
        m_Button.SetWindowText(_T(""));
    }
    else
    {
        m_Button.SetWindowText(_T("Button"));
    }


...


    // Resize the button.
    m_Button.SizeToContent();
    m_Button.EnableFullTextTooltip(true);
    // Use the application menu font at the button text font.
    m_Button.EnableMenuFont();
    // Use the current Windows theme to draw the button borders.
    m_Button.EnableWindowsTheming(true);
    // Set the button to auto-repeat mode.
    m_Button.SetAutorepeatMode();
    // Set the background color for the button text.
    m_Button.SetFaceColor(RGB(255,0,0),true);
    m_Button.SetTextColor(RGB(0,0,255));
    // Set the tooltip of the button.
    m_Button.SetTooltip(_T("this is a button!"));