CMFCRibbonCheckBox-Klasse

Die CMFCRibbonCheckBox-Klasse implementiert ein Kontrollkästchen, das einem Menübandbereich, einer Symbolleiste für den Schnellzugriff oder einem Popupmenü hinzugefügt werden kann.

Syntax

class CMFCRibbonCheckBox : public CMFCRibbonButton

Member

Öffentliche Konstruktoren

Name	Beschreibung
CMFCRibbonCheckBox::CMFCRibbonCheckBox	Der Konstruktor.

Öffentliche Methoden

Name	Beschreibung
CMFCRibbonCheckBox::GetCompactSize	(Außerkraftsetzungen CMFCRibbonButton::GetCompactSize.)
CMFCRibbonCheckBox::GetIntermediateSize	(Außerkraftsetzungen CMFCRibbonButton::GetIntermediateSize.)
CMFCRibbonCheckBox::GetRegularSize	(Außerkraftsetzungen CMFCRibbonButton::GetRegularSize.)
CMFCRibbonCheckBox::IsDrawTooltipImage	(Überschreibt CMFCRibbonButton::IsDrawTooltipImage.)
CMFCRibbonCheckBox::OnDraw	(Außerkraftsetzungen CMFCRibbonButton::OnDraw.)
CMFCRibbonCheckBox::OnDrawMenuImage	(Außerkraftsetzungen CMFCRibbonBaseElement::OnDrawMenuImage.)
CMFCRibbonCheckBox::OnDrawOnList	(Überschreibt CMFCRibbonButton::OnDrawOnList.)
CMFCRibbonCheckBox::SetACCData	(Außerkraftsetzungen CMFCRibbonButton::SetACCData.)

Hinweise

Fügen Sie zum Verwenden von CMFCRibbonCheckBox in Ihrer Anwendung Ihrem Code den folgenden Konstruktor hinzu:

CMFCRibbonCheckBox (UINT nID, LPCTSTR lpszText)

Dabei ist nID die Befehls-ID des Kontrollkästchens, und lpszText ist die Textbezeichnung des Kontrollkästchens.

Sie können einem Menübandbereich ein Kontrollkästchen hinzufügen, indem Sie CMFCRibbonPanel::Add verwenden.

Vererbungshierarchie

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonCheckBox

Anforderungen

Header: afxribboncheckbox.h

CMFCRibbonCheckBox::CMFCRibbonCheckBox

Konstruktor eines Menüband-Kontrollkästchenobjekts

CMFCRibbonCheckBox(
    UINT nID,
    LPCTSTR lpszText);

Parameter

Nid
[in] Gibt die Befehls-ID an.

lpszText
[in] Gibt die Beschriftung an.

Rückgabewert

Erstellt ein Kontrollkästchenobjekt des Menübands.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie ein Objekt der CMFCRibbonCheckBox Klasse erstellt wird.

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

CMFCRibbonCheckBox::GetCompactSize

Ruft beim Überschreiben die kompakte Größe des Kontrollkästchens ab.

virtual CSize GetCompactSize(CDC* pDC);

Parameter

pDC
[in] Zeiger auf das CDC, das dem Kontrollkästchen zugeordnet ist.

Rückgabewert

Gibt ein CSize Objekt zurück, das die kompakte Größe des Kontrollkästchens enthält.

Hinweise

Wenn das Kontrollkästchen nicht überschrieben wird, wird die Zwischengröße des Kontrollkästchens zurückgegeben.

CMFCRibbonCheckBox::GetIntermediateSize

Ruft die Zwischengröße des Kontrollkästchens ab.

virtual CSize GetIntermediateSize(CDC* pDC);

Parameter

pDC
[in] Zeiger auf das CDC, das diesem Kontrollkästchen zugeordnet ist.

Rückgabewert

Ein CSize Objekt, das die Zwischengröße des Kontrollkästchens enthält.

Hinweise

Wenn dies nicht überschrieben wird, wird die Zwischengröße als Standardgröße des Kontrollkästchens ( AFX_CHECK_BOX_DEFAULT_SIZE) sowie die Textgröße plus Ränder berechnet.

CMFCRibbonCheckBox::GetRegularSize

Ruft die normale Größe des Kontrollkästchens ab.

virtual CSize GetRegularSize(CDC* pDC);

Parameter

pDC
[in] Zeiger auf das CDC-Objekt, das diesem Kontrollkästchen zugeordnet ist.

Rückgabewert

Gibt ein CSize Objekt zurück, das die normale Größe des Kontrollkästchens enthält.

Hinweise

Wenn das Kontrollkästchen nicht überschrieben wird, wird die Zwischengröße des Kontrollkästchens zurückgegeben.

CMFCRibbonCheckBox::IsDrawTooltipImage

Gibt an, ob dem Kontrollkästchen ein QuickInfo-Bild zugeordnet ist.

virtual BOOL IsDrawTooltipImage() const;

Rückgabewert

Gibt WAHR zurück, wenn dem Kontrollkästchen ein QuickInfo-Bild zugeordnet ist, oder FALSE, wenn dies nicht der Fall ist.

Hinweise

CMFCRibbonCheckBox::OnDraw

Wird vom Framework aufgerufen, um das Kontrollkästchen mithilfe eines angegebenen Gerätekontexts zu zeichnen.

virtual void OnDraw(CDC* pDC);

Parameter

pDC
[in] Zeigen Sie auf das CDC, in dem das Kontrollkästchen gezeichnet werden soll.

Hinweise

CMFCRibbonCheckBox::OnDrawMenuImage

Wird vom Framework aufgerufen, um ein Menübild für das Kontrollkästchen zu zeichnen.

virtual BOOL OnDrawMenuImage(CDC*, CRect);

Parameter

[in] CDC*
Zeiger auf das CDC, das dem Kontrollkästchen zugeordnet ist.

CRect
[in] Ein CRect Objekt, das das Rechteck angibt, in dem das Menübild gezeichnet werden soll.

Rückgabewert

Gibt WAHR zurück, wenn das Bild gezeichnet wurde, oder FALSE, wenn dies nicht der Fall ist.

Hinweise

Wenn dies nicht überschrieben wird, wird FALSE zurückgegeben.

CMFCRibbonCheckBox::OnDrawOnList

Wird vom Framework aufgerufen, um das Kontrollkästchen in einem Befehlslistenfeld zu zeichnen.

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

Parameter

pDC
[in] Zeigen Sie auf den Gerätekontext, in dem das Kontrollkästchen gezeichnet werden soll.

strText
[in] Der Anzeigetext.

nTextOffset
[in] Der Abstand in Pixel vom linken Rand des Listenfelds zum Anzeigetext.

Rect
[in] Das Anzeigerechteck für das Kontrollkästchen.

bIsSelected
[in] TRUE, wenn das Kontrollkästchen aktiviert ist, oder FALSE, wenn dies nicht der Fall ist.

bHighlighted
[in] TRUE, wenn das Kontrollkästchen hervorgehoben ist, oder FALSE, wenn dies nicht der Fall ist.

Hinweise

CMFCRibbonCheckBox::SetACCData

Legt die Barrierefreiheitsdaten für das Kontrollkästchen fest.

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

Parameter

pParent
Das übergeordnete Fenster des Kontrollkästchens.

data
Die Barrierefreiheitsdaten für das Kontrollkästchen.

Rückgabewert

Gibt immer TRUE zurück.

Hinweise

Standardmäßig legt diese Methode die Barrierefreiheitsdaten für das Kontrollkästchen fest und gibt immer TRUE zurück. Setzen Sie diese Methode außer Kraft, um die Barrierefreiheitsdaten festzulegen und einen Wert zurückzugeben, der den Erfolg oder einen Fehler angibt.

Siehe auch

Hierarchiediagramm
Klassen
CMFCRibbonPanel-Klasse