CMFCRibbonCheckBox 類別
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，將複選框新增至功能區面板。
繼承階層架構
需求
標頭： 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]從清單框左側到顯示文字的距離，以像素為單位。
rect
[in]選取框的顯示矩形。
bIsSelected
[in]如果選取複選框，則為TRUE，否則為 FALSE。
bHighlighted
[in]如果反白顯示複選框，則為TRUE，否則為 FALSE。
備註
CMFCRibbonCheckBox：：SetACCData
設定複選框的輔助功能數據。
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
參數
pParent
複選框的父視窗。
data
選取框的輔助功能數據。
傳回值
一律會傳回 TRUE。
備註
根據預設，此方法會設定複選框的輔助功能數據，且一律會傳回 TRUE。 覆寫此方法以設定協助工具資料並傳回值，以指出成功或失敗。