CButton 類別

發行項
02/28/2013

提供 Windows 按鈕控制項的功能。

class CButton : public CWnd

Members

公用建構函式

名稱	描述
CButton::CButton	建構 CButton 物件。

公用方法

名稱	描述
CButton::Create	建立 Windows 按鈕控制項並將其附加至 CButton 物件。
CButton::DrawItem	繪製主控描繪 CButton 物件的覆寫。
CButton::GetBitmap	擷取點陣圖的控制代碼之前設定與 SetBitmap。
CButton::GetButtonStyle	擷取與按鈕控制項樣式的資訊。
CButton::GetCheck	擷取按鈕控制項的選取狀態。
CButton::GetCursor	擷取游標影像的控制代碼之前設定與 SetCursor。
CButton::GetIcon	擷取圖示的控制代碼之前設定與 SetIcon。
CButton::GetIdealSize	擷取按鈕控制項的理想的大小。
CButton::GetImageList	擷取按鈕控制項影像清單。
CButton::GetNote	擷取目前命令連結控制元件的注意事項。
CButton::GetNoteLength	擷取附註文字長度目前命令連結控制項的。
CButton::GetSplitGlyph	擷取影像與目前分割按鈕控制項。
CButton::GetSplitImageList	擷取目前分割按鈕控制項的影像清單。
CButton::GetSplitInfo	擷取定義目前分割按鈕控制項的相關資訊。
CButton::GetSplitSize	擷取目前分割按鈕控制項的下拉式元件的週框 (Bounding Rectangle)。
CButton::GetSplitStyle	擷取定義目前分割按鈕控制項的分割按鈕樣式。
CButton::GetState	擷取核取狀態、焦點狀態和按鈕控制項的焦點狀態。
CButton::GetTextMargin	擷取按鈕控制項的文字框線。
CButton::SetBitmap	指定要在按鈕中顯示的點陣圖。
CButton::SetButtonStyle	變更按鈕的樣式。
CButton::SetCheck	將按鈕控制項的選取狀態。
CButton::SetCursor	指定要在按鈕中顯示的游標影像。
CButton::SetDropDownState	設定目前分割按鈕控制項的下拉狀態。
CButton::SetIcon	指定要在按鈕中顯示的圖示。
CButton::SetImageList	將按鈕控制項影像清單。
CButton::SetNote	設定有關目前命令連結控制的注意事項。
CButton::SetSplitGlyph	使指定的影像和目前分割按鈕控制項。
CButton::SetSplitImageList	相關聯的影像清單與目前分割按鈕控制項。
CButton::SetSplitInfo	指定定義目前分割按鈕控制項的相關資訊。
CButton::SetSplitSize	設定目前分割按鈕控制項的下拉式元件的週框 (Bounding Rectangle)。
CButton::SetSplitStyle	設定目前分割按鈕控制項的樣式。
CButton::SetState	將按鈕控制項的反白顯示的狀態。
CButton::SetTextMargin	將按鈕控制項的文字框線。

備註

按鈕控制項是可以斷斷續續按一下的小矩形，子視窗。按鈕單獨使用或在群組中，而可以標示或外觀，而不用文字。當使用者按一下該按鈕時，通常會變更外觀。

一般按鈕為核取方塊、選項按鈕和按鈕。 CButton 物件可以根據按鈕樣式成為每一個，指定在其初始化由建立成員函式。

此外，從 CButton 衍生的 CBitmapButton 類別支援按鈕控制項的建立標記的點陣圖影像 (而非文字。 CBitmapButton 可以具有按鈕的，關閉，焦點和停用狀態的個別的點陣圖。

您可以建立一個按鈕控制項從對話方塊範本或直接在您的程式碼。在這兩種情況下，請先呼叫建構 CButton 物件的 CButton ;然後呼叫建立成員函式建立 Windows 按鈕控制項並將它附加至 CButton 物件。

語法結構可以是從 CButton從衍生之類別中的程序。提供衍生類別的建構函式和呼叫建立從建構函式中呼叫。

如果您想要處理 Windows 按鈕控制項傳送通知訊息至其父 CDialog(通常是從衍生的類別)，將訊息對應 (Message Map 輸入和訊息處理常式成員函式來為每則訊息的父類別。

每個訊息對應 (Message Map 輸入的格式如下:

ON_告知(id， memberFxn)

其中 id 指定正在傳送之控制項的子視窗 ID 告知和 memberFxn 是您撰寫處理告知父代成員函式的名稱。

父的函式原型 (Prototype) 如下:

afx_msgvoidmemberFxn**( );**

可能的訊息對應 (Message Map 輸入如下:

對應項目	傳送父代，當…
ON_BN_CLICKED	使用者按一下按鈕。
ON_BN_DOUBLECLICKED	使用者按一下按鈕。

如果您從對話方塊資源的 CButton 物件，自動終結 CButton 物件，在使用者關閉對話方塊時。

如果您在視窗內的 CButton 物件，可能要終結它。您可以使用 new 函式，建立。 CButton 堆積中的物件，您必須呼叫物件上的刪除終結它，當使用者關閉 Windows 按鈕控制項時。如果您在堆疊上建立 CButton 物件，或是在父對話方塊物件是內嵌，自動終結。