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
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.