CMFCRibbonCheckBox 類別

發行項
10/12/2023

CMFCRibbonCheckBox 類別實作可以加入至功能區面板、快速存取工具列或快顯功能表的核取方塊。

語法

class CMFCRibbonCheckBox : public CMFCRibbonButton

成員

公用建構函式

名稱	描述
CMFCRibbonCheckBox：：CMFCRibbonCheckBox	建構函式。

公用方法

名稱	描述
CMFCRibbonCheckBox：：GetCompactSize	（覆寫 CMFCRibbonButton：：GetCompactSize .）
CMFCRibbonCheckBox：：GetIntermediateSize	（覆寫 CMFCRibbonButton：：GetIntermediateSize .）
CMFCRibbonCheckBox：：GetRegularSize	（覆寫 CMFCRibbonButton：：GetRegularSize .）
CMFCRibbonCheckBox：：IsDrawTooltipImage	(覆寫 `CMFCRibbonButton::IsDrawTooltipImage`。)
CMFCRibbonCheckBox：：OnDraw	（覆寫 CMFCRibbonButton：：OnDraw .）
CMFCRibbonCheckBox：：OnDrawMenuImage	（覆寫 CMFCRibbonBaseElement：：OnDrawMenuImage .）
CMFCRibbonCheckBox：：OnDrawOnList	(覆寫 `CMFCRibbonButton::OnDrawOnList`。)
CMFCRibbonCheckBox：：SetACCData	（覆寫 CMFCRibbonButton：：SetACCData .）

備註

若要在應用程式中使用 CMFCRibbonCheckBox，請將下列建構函式加入至您的程式碼：

CMFCRibbonCheckBox (UINT nID, LPCTSTR lpszText)

其中 nID 是核取方塊命令識別碼， lpszText 是核取方塊的文字標籤。

您可以使用 CMFCRibbonPanel：：Add ，將核取方塊新增至功能區面板。

繼承階層架構

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonCheckBox

需求

標頭： afxribboncheckbox.h

CMFCRibbonCheckBox：：CMFCRibbonCheckBox

功能區核取方塊物件的建構函式

CMFCRibbonCheckBox(
    UINT nID,
    LPCTSTR lpszText);

參數

nID
[in]指定命令識別碼。

lpszText
[in]指定文字標籤。

傳回值

建構功能區核取方塊物件。

範例

下列範例示範如何建構類別的物件 CMFCRibbonCheckBox 。

strTemp.LoadString(IDS_RIBBON_STATUSBAR);
CMFCRibbonButton *pBtnStatusBar = new CMFCRibbonCheckBox(ID_VIEW_STATUS_BAR, strTemp);

CMFCRibbonCheckBox：：GetCompactSize

覆寫時，取得核取方塊的精簡大小。

virtual CSize GetCompactSize(CDC* pDC);

參數

pDC
[in]與核取方塊相關聯的 CDC 指標。

傳回值

傳 CSize 回物件，其中包含核取方塊的精簡大小。

備註

如果未覆寫，則會傳回復選框的中繼大小。

CMFCRibbonCheckBox：：GetIntermediateSize

取得核取方塊的中繼大小。

virtual CSize GetIntermediateSize(CDC* pDC);

參數

pDC
[in]與此核取方塊相關聯的 CDC 指標。

傳回值

CSize物件，包含核取方塊的中繼大小。

備註

如果未覆寫，則會將中繼大小計算為預設核取方塊大小（ AFX_CHECK_BOX_DEFAULT_SIZE ）加上文字大小，加上邊界。

CMFCRibbonCheckBox：：GetRegularSize

取得核取方塊的一般大小。

virtual CSize GetRegularSize(CDC* pDC);

參數

pDC
[in]與此核取方塊相關聯的 CDC 物件的指標。

傳回值

傳 CSize 回物件，其中包含核取方塊的一般大小。

備註

如果未覆寫，則會傳回復選框的中繼大小。

CMFCRibbonCheckBox：：IsDrawTooltipImage

指出是否有與核取方塊相關聯的工具提示影像。

virtual BOOL IsDrawTooltipImage() const;

傳回值

如果有與核取方塊相關聯的工具提示影像，則傳回 TRUE，否則傳回 FALSE。

備註

CMFCRibbonCheckBox：：OnDraw

由架構呼叫，以使用指定的裝置內容繪製核取方塊。

virtual void OnDraw(CDC* pDC);

參數

pDC
[in]要在其中繪製核取方塊之 CDC 的指標。

備註

CMFCRibbonCheckBox：：OnDrawMenuImage

由架構呼叫以繪製核取方塊的功能表影像。

virtual BOOL OnDrawMenuImage(CDC*, CRect);

參數

[輸入] CDC*
與核取方塊相關聯的 CDC 指標。

CRect
[in] CRect 物件，指定要在其中繪製功能表影像的矩形。

傳回值

如果繪製影像，則傳回 TRUE，否則傳回 FALSE。

備註

如果未覆寫，則傳回 FALSE。

CMFCRibbonCheckBox：：OnDrawOnList

由架構呼叫，以在命令清單方塊中繪製核取方塊。

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

參數

pDC
[in]要在其中繪製核取方塊之裝置內容的指標。

strText
[in]顯示文字。

nTextOffset
[in]從清單方塊左側到顯示文字的距離，以圖元為單位。

矩形
[in]核取方塊的顯示矩形。

bIsSelected
[in]如果選取核取方塊，則為 TRUE，否則為 FALSE。

bHighlighted
[in]如果反白顯示覆選框，則為 TRUE，否則為 FALSE。

備註

CMFCRibbonCheckBox：：SetACCData

設定核取方塊的協助工具資料。

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

參數

pParent
核取方塊的父視窗。

data
核取方塊的協助工具資料。

傳回值

一律會傳回 TRUE。

備註

根據預設，此方法會設定核取方塊的協助工具資料，且一律會傳回 TRUE。覆寫此方法以設定協助工具資料並傳回值，以指出成功或失敗。

另請參閱

階層架構圖表
 類別
 CMFCRibbonPanel 類別

共用方式為