CMFCRibbonEdit-Klasse
Implementiert ein Bearbeitungssteuerelement, das sich auf einer Menübandleiste befindet.
Syntax
class CMFCRibbonEdit : public CMFCRibbonButton
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CMFCRibbonEdit::CMFCRibbonEdit | Erstellt ein CMFCRibbonEdit-Objekt. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CMFCRibbonEdit::CanBeStretched | Gibt an, ob die Höhe des CMFCRibbonEdit Steuerelements vertikal auf die Höhe einer Menübandzeile erhöht werden kann. |
| CMFCRibbonEdit::CMFCRibbonEdit | Erstellt ein CMFCRibbonEdit-Objekt. |
| CMFCRibbonEdit::CopyFrom | Kopiert den Status des angegebenen CMFCRibbonEdit Objekts in das aktuelle CMFCRibbonEdit Objekt. |
| CMFCRibbonEdit::CreateEdit | Erstellt ein neues Textfeld für das CMFCRibbonEdit Objekt. |
| CMFCRibbonEdit::D estroyCtrl | Zerstört das CMFCRibbonEdit-Objekt. |
| CMFCRibbonEdit::D ropDownList | Legt ein Listenfeld herunter. |
| CMFCRibbonEdit::EnableSpinButtons | Aktiviert und legt den Bereich der Drehschaltfläche für das Textfeld fest. |
| CMFCRibbonEdit::GetCompactSize | Ruft die kompakte Größe des CFMCRibbonEdit Objekts ab. |
| CMFCRibbonEdit::GetEditText | Ruft den Text im Textfeld ab. |
| CMFCRibbonEdit::GetIntermediateSize | Ruft die Zwischengröße des CMFCRibbonEdit Objekts ab. |
| CMFCRibbonEdit::GetTextAlign | Ruft die Ausrichtung des Texts im Textfeld ab. |
| CMFCRibbonEdit::GetWidth | Ruft die Breite des Steuerelements in Pixeln ab CMFCRibbonEdit . |
| CMFCRibbonEdit::HasCompactMode | Gibt an, ob die Anzeigegröße für das CMFCRibbonEdit Steuerelement kompakt sein kann. |
| CMFCRibbonEdit::HasFocus | Gibt an, ob das CMFCRIbbonEdit Steuerelement den Fokus hat. |
| CMFCRibbonEdit::HasLargeMode | Gibt an, ob die Anzeigegröße für das CMFCRibbonEdit Steuerelement groß sein kann. |
| CMFCRibbonEdit::HasSpinButtons | Gibt an, ob das Textfeld über eine Drehschaltfläche verfügt. |
| CMFCRibbonEdit::IsHighlighted | Gibt an, ob das CMFCRibbonEdit Steuerelement hervorgehoben ist. |
| CMFCRibbonEdit::OnAfterChangeRect | Wird vom Framework aufgerufen, wenn sich die Abmessungen des Anzeigerechtecks für das CMFCRibbonEdit Steuerelement ändern. |
| CMFCRibbonEdit::OnDraw | Wird vom Framework aufgerufen, um das CMFCRibbonEdit Steuerelement zu zeichnen. |
| CMFCRibbonEdit::OnDrawLabelAndImage | Wird vom Framework aufgerufen, um die Beschriftung und das Bild für das CMFCRibbonEdit Steuerelement zu zeichnen. |
| CMFCRibbonEdit::OnDrawOnList | Wird vom Framework aufgerufen, um das CMFCRibbonEdit Steuerelement in einem Befehlslistenfeld zu zeichnen. |
| CMFCRibbonEdit::OnEnable | Vom Framework aufgerufen, um das CMFCRibbonEdit Steuerelement zu aktivieren oder zu deaktivieren. |
| CMFCRibbonEdit::OnHighlight | Wird vom Framework aufgerufen, wenn der Zeiger die Grenzen des CMFCRibbonEdit Steuerelements eingibt oder verlässt. |
| CMFCRibbonEdit::OnKey | Wird vom Framework aufgerufen, wenn der Benutzer eine Zugriffstasteninfo drückt und das CMFCRibbonEdit Steuerelement den Fokus hat. |
| CMFCRibbonEdit::OnLButtonDown | Wird vom Framework aufgerufen, um das CMFCRibbonEdit Steuerelement zu aktualisieren, wenn der Benutzer die linke Maustaste auf dem Steuerelement drückt. |
| CMFCRibbonEdit::OnLButtonUp | Wird vom Framework aufgerufen, wenn der Benutzer die linke Maustaste loslässt. |
| CMFCRibbonEdit::OnRTLChanged | Wird vom Framework aufgerufen, um das CMFCRibbonEdit Steuerelement zu aktualisieren, wenn sich die Layoutrichtung ändert. |
| CMFCRibbonEdit::OnShow | Wird vom Framework aufgerufen, um das CMFCRibbonEdit Steuerelement ein- oder auszublenden. |
| CMFCRibbonEdit::Redraw | Aktualisiert die Anzeige des CMFCRibbonEdit Steuerelements. |
| CMFCRibbonEdit::SetACCData | Legt die Barrierefreiheitsdaten für das CMFCRibbonEdit Objekt fest. |
| CMFCRibbonEdit::SetEditText | Legt den Text im Textfeld fest. |
| CMFCRibbonEdit::SetTextAlign | Legt die Textausrichtung des Textfelds fest. |
| CMFCRibbonEdit::SetWidth | Legt die Breite des Textfelds für das CMFCRibbonEdit Steuerelement fest. |
Hinweise
Beispiel
Im folgenden Beispiel wird veranschaulicht, wie ein CMFCRibbonEdit Objekt erstellt, Drehschaltflächen neben dem Bearbeitungssteuerelement angezeigt und der Text des Bearbeitungssteuerelements festgelegt wird. Dieser Codeausschnitt ist Teil des MS Office 2007-Demobeispiels.
CMFCRibbonEdit *pEditIndentLeft = new CMFCRibbonEdit(ID_PAGELAYOUT_INDENT_LEFT, 72, _T("Left:\nil"), 13);
// specify the min and max value of the spin button control
pEditIndentLeft->EnableSpinButtons(0, 1000);
// set the text of the edit control
pEditIndentLeft->SetEditText(_T("0"));
Anforderungen
Kopfzeile: afxRibbonEdit.h
CMFCRibbonEdit::CanBeStretched
Gibt an, ob die Höhe des CMFCRibbonEdit-Steuerelements vertikal auf die Höhe einer Menübandzeile erhöht werden kann.
virtual BOOL CanBeStretched();
Rückgabewert
Gibt immer FALSE zurück.
Hinweise
CMFCRibbonEdit::CMFCRibbonEdit
Erstellt ein CMFCRibbonEdit -Objekt.
CMFCRibbonEdit(
UINT nID,
int nWidth,
LPCTSTR lpszLabel = NULL,
int nImage = -1);
CMFCRibbonEdit();
Parameter
Nid
[in] Befehls-ID für das CMFCRibbonEdit Steuerelement.
nWidth
[in] Die Breite des Textfelds für das CMFCRibbonEdit Steuerelement in Pixel.
lpszLabel
[in] Die Bezeichnung für das CMFCRibbonEdit Steuerelement.
nImage
[in] Index des kleinen Bilds, das für das CMFCRibbonEdit Steuerelement verwendet werden soll. Die Sammlung kleiner Bilder wird von der übergeordneten Menübandkategorie verwaltet.
Hinweise
Das CMFCRibbonEdit Steuerelement verwendet kein großes Bild.
CMFCRibbonEdit::CopyFrom
Kopiert den Status des angegebenen CMFCRibbonEdit -Objekts in das aktuelle CMFCRibbonEdit -Objekt.
virtual void CopyFrom(const CMFCRibbonBaseElement& src);
Parameter
src
[in] Das Quellobjekt CMFCRibbonEdit .
Hinweise
Der src-Parameter muss vom Typ CMFCRibbonEditsein.
CMFCRibbonEdit::CreateEdit
Erstellt ein neues Textfeld für das CMFCRibbonEdit -Objekt.
virtual CMFCRibbonRichEditCtrl* CreateEdit(
CWnd* pWndParent,
DWORD dwEditStyle);
Parameter
pWndParent
[in] Ein Zeiger auf das übergeordnete Fenster des CMFCRibbonEdit Objekts.
dwEditStyle
[in] Gibt die Formatvorlage des Textfelds an. Sie können die im Abschnitt "Hinweise" aufgeführten Fensterformatvorlagen mit den im Windows SDK beschriebenen Bearbeitungssteuerelementstilen kombinieren.
Rückgabewert
Ein Zeiger auf das neue Textfeld, wenn die Methode erfolgreich war; andernfalls NULL.
Hinweise
Überschreiben Sie diese Methode in einer abgeleiteten Klasse, um ein benutzerdefiniertes Textfeld zu erstellen.
Sie können die folgenden Fensterformatvorlagen auf ein Textfeld anwenden:
WS_CHILD
WS_VISIBLE
WS_DISABLED
WS_GROUP
WS_TABSTOP
CMFCRibbonEdit::D estroyCtrl
Zerstört das CMFCRibbonEdit -Objekt.
virtual void DestroyCtrl();
Hinweise
CMFCRibbonEdit::D ropDownList
Legt ein Listenfeld herunter.
virtual void DropDownList();
Hinweise
Standardmäßig führt diese Methode nichts aus. Überschreiben Sie diese Methode, um ein Listenfeld auflisten zu können.
CMFCRibbonEdit::EnableSpinButtons
Aktiviert und legt den Bereich der Drehschaltfläche für das Textfeld fest.
void EnableSpinButtons(
int nMin,
int nMax);
Parameter
nMin
[in] Der Mindestwert der Drehschaltfläche.
nMax
[in] Der Maximalwert der Drehschaltfläche.
Hinweise
Drehschaltflächen zeigen einen Pfeil nach oben und unten an und ermöglichen Es Benutzern, durch eine feste Gruppe von Werten zu navigieren.
CMFCRibbonEdit::GetCompactSize
Ruft die kompakte Größe des CMFCRibbonEdit -Objekts ab.
virtual CSize GetCompactSize(CDC* pDC);
Parameter
pDC
[in] Zeigen Sie auf einen Gerätekontext für das CMFCRibbonEdit Objekt.
Rückgabewert
Die kompakte Größe des CMFCRibbonEdit Objekts.
Hinweise
CMFCRibbonEdit::GetEditText
Ruft den Text im Textfeld ab.
CString GetEditText() const;
Rückgabewert
Der Text im Textfeld.
Hinweise
CMFCRibbonEdit::GetIntermediateSize
Ruft die Zwischengröße des CMFCRibbonEdit -Objekts ab.
virtual CSize GetIntermediateSize(CDC* pDC);
Parameter
pDC
[in] Zeigen Sie auf einen Gerätekontext für das CMFCRibbonEdit Objekt.
Rückgabewert
Die Zwischengröße des CMFCRibbonEdit Objekts.
Hinweise
CMFCRibbonEdit::GetTextAlign
Ruft die Ausrichtung des Texts im Textfeld ab.
int GetTextAlign() const;
Rückgabewert
Ein aufgezählter Textausrichtungswert. Mögliche Werte finden Sie im Abschnitt Anmerkungen.
Hinweise
Der zurückgegebene Wert ist eine der folgenden Bearbeitungssteuerelementstile:
ES_LEFT für die linke Ausrichtung
ES_CENTER für die zentrieren Ausrichtung
ES_RIGHT für die rechte Ausrichtung
Weitere Informationen zu diesen Formatvorlagen finden Sie unter Bearbeiten von Steuerelementformatvorlagen.
CMFCRibbonEdit::GetWidth
Ruft die Breite des CMFCRibbonEdit-Steuerelements in Pixeln ab.
int GetWidth(BOOL bInFloatyMode = FALSE) const;
Parameter
bInFloatyMode
[in] TRUE, wenn sich das CMFCRibbonEdit Steuerelement im unverankerten Modus befindet; andernfalls FALSE.
Rückgabewert
Die Breite des Steuerelements CMFCRibbonEdit in Pixel.
Hinweise
CMFCRibbonEdit::HasCompactMode
Gibt an, ob die Anzeigegröße für das CMFCRibbonEdit-Steuerelement kompakt sein kann.
virtual BOOL HasCompactMode() const;
Rückgabewert
Gibt immer TRUE zurück.
Hinweise
Standardmäßig gibt diese Methode immer TRUE zurück. Überschreiben Sie diese Methode, um anzugeben, ob die Anzeigegröße kompakt sein kann.
CMFCRibbonEdit::HasFocus
Gibt an, ob das CMFCRibbonEdit -Steuerelement den Fokus hat.
virtual BOOL HasFocus() const;
Rückgabewert
TRUE, wenn das CMFCRibbonEdit Steuerelement den Fokus hat; andernfalls FALSE.
Hinweise
CMFCRibbonEdit::HasLargeMode
Gibt an, ob die Anzeigegröße für das CMFCRibbonEdit -Steuerelement groß sein kann.
virtual BOOL HasLargeMode() const;
Rückgabewert
Gibt immer FALSE zurück.
Hinweise
Standardmäßig gibt diese Methode immer FALSE zurück. Überschreiben Sie diese Methode, um anzugeben, ob die Anzeigegröße groß sein kann.
CMFCRibbonEdit::HasSpinButtons
Gibt an, ob das Textfeld über eine Drehschaltfläche verfügt.
virtual BOOL HasSpinButtons() const;
Rückgabewert
TRUE, wenn das Textfeld über eine Drehschaltfläche verfügt; andernfalls FALSE.
Hinweise
CMFCRibbonEdit::IsHighlighted
Gibt an, ob das CMFCRibbonEdit-Steuerelement hervorgehoben ist.
virtual BOOL IsHighlighted() const;
Rückgabewert
TRUE, wenn das CMFCRibbonEdit Steuerelement hervorgehoben ist; andernfalls FALSE.
Hinweise
CMFCRibbonEdit::OnAfterChangeRect
Wird vom Framework aufgerufen, wenn sich die Abmessungen des Anzeigerechtecks für das CMFCRibbonEdit-Steuerelement ändern.
virtual void OnAfterChangeRect(CDC* pDC);
Parameter
pDC
[in] Zeigen Sie auf einen Gerätekontext für das CMFCRibbonEdit Steuerelement.
Hinweise
CMFCRibbonEdit::OnDraw
Wird vom Framework aufgerufen, um das CMFCRibbonEdit-Steuerelement zu zeichnen.
virtual void OnDraw(CDC* pDC);
Parameter
pDC
[in] Zeigen Sie auf einen Gerätekontext für das CMFCRibbonEdit Steuerelement.
Hinweise
CMFCRibbonEdit::OnDrawLabelAndImage
Wird vom Framework aufgerufen, um die Bezeichnung und das Bild für das CMFCRibbonEdit-Steuerelement zu zeichnen.
virtual void OnDrawLabelAndImage(CDC* pDC);
Parameter
pDC
[in] Zeigen Sie auf einen Gerätekontext für das CMFCRibbonEdit Steuerelement.
Hinweise
CMFCRibbonEdit::OnDrawOnList
Wird vom Framework aufgerufen, um das CMFCRibbonEdit-Steuerelement 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 einen Gerätekontext für das CMFCRibbonEdit Steuerelement.
strText
[in] Der Anzeigetext.
nTextOffset
[in] Abstand (in Pixel) von der linken Seite des Listenfelds zum Anzeigetext.
rect
[in] Das Anzeigerechteck für das CMFCRibbonEdit Steuerelement.
bIsSelected
[in] Dieser Parameter wird nicht verwendet.
bHighlighted
[in] Dieser Parameter wird nicht verwendet.
Hinweise
Im Listenfeld "Befehle" werden Menübandsteuerelemente angezeigt, damit Benutzer die Symbolleiste für den Schnellzugriff anpassen können.
CMFCRibbonEdit::OnEnable
Vom Framework aufgerufen, um das CMFCRibbonEdit-Steuerelement zu aktivieren oder zu deaktivieren.
virtual void OnEnable(BOOL bEnable);
Parameter
bEnable
[in] TRUE, um das Steuerelement zu aktivieren; FALSE, um das Steuerelement zu deaktivieren.
Hinweise
CMFCRibbonEdit::OnHighlight
Wird vom Framework aufgerufen, wenn der Zeiger die Grenzen des CMFCRibbonEdit-Steuerelements eingibt oder verlässt.
virtual void OnHighlight(BOOL bHighlight);
Parameter
bHighlight
[in] TRUE, wenn sich der Zeiger in den Grenzen des CMFCRibbonEdit Steuerelements befindet; andernfalls FALSE.
Hinweise
CMFCRibbonEdit::OnKey
Wird vom Framework aufgerufen, wenn der Benutzer eine Zugriffstasteninfo drückt und das CMFCRibbonEdit-Steuerelement den Fokus hat.
virtual BOOL OnKey(BOOL bIsMenuKey);
Parameter
bIsMenuKey
[in] TRUE, wenn die Zugriffstasteninfo ein Popupmenü anzeigt; andernfalls FALSE.
Rückgabewert
TRUE, wenn das Ereignis behandelt wurde; andernfalls FALSE.
Hinweise
CMFCRibbonEdit::OnLButtonDown
Wird vom Framework aufgerufen, um das CMFCRibbonEdit-Steuerelement zu aktualisieren, wenn der Benutzer die linke Maustaste auf dem Steuerelement drückt.
virtual void OnLButtonDown(CPoint point);
Parameter
Punkt
[in] Dieser Parameter wird nicht verwendet.
Hinweise
CMFCRibbonEdit::OnLButtonUp
Wird vom Framework aufgerufen, wenn der Benutzer die linke Maustaste loslässt.
virtual void OnLButtonUp(CPoint point);
Parameter
Punkt
[in] Dieser Parameter wird nicht verwendet.
Hinweise
CMFCRibbonEdit::OnRTLChanged
Wird vom Framework aufgerufen, um das CMFCRibbonEdit-Steuerelement zu aktualisieren, wenn sich die Layoutrichtung ändert.
virtual void OnRTLChanged(BOOL bIsRTL);
Parameter
bIsRTL
[in] TRUE, wenn das Layout von rechts nach links ist; FALSE, wenn das Layout von links nach rechts ist.
Hinweise
CMFCRibbonEdit::OnShow
Wird vom Framework aufgerufen, um das CMFCRibbonEdit-Steuerelement ein- oder auszublenden.
virtual void OnShow(BOOL bShow);
Parameter
bShow
[in] TRUE, um das Steuerelement anzuzeigen; FALSE, um das Steuerelement auszublenden.
Hinweise
CMFCRibbonEdit::Redraw
Aktualisiert die Anzeige des CMFCRibbonEdit-Steuerelements .
virtual void Redraw();
Hinweise
Mit dieser Methode wird das Anzeigerechteck für das CMFCRibbonEdit Objekt neu gezeichnet, indem indirekt CWnd::RedrawWindow aufgerufen wird, wobei die RDW_INVALIDATE, RDW_ERASE und RDW_UPDATENOW Flags festgelegt sind.
CMFCRibbonEdit::SetACCData
Legt die Barrierefreiheitsdaten für das CMFCRibbonEdit -Objekt fest.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Parameter
pParent
Zeigen Sie auf das übergeordnete Fenster für das CMFCRibbonEdit Objekt.
data
Die Barrierefreiheitsdaten für das CMFCRibbonEdit Objekt.
Rückgabewert
Gibt immer TRUE zurück.
Hinweise
CMFCRibbonEdit::SetEditText
Legt den Text im Textfeld fest.
void SetEditText(CString strText);
Parameter
strText
[in] Der Text für das Textfeld.
CMFCRibbonEdit::SetTextAlign
Legt die Textausrichtung des Textfelds fest.
void SetTextAlign(int nAlign);
Parameter
nAlign
[in] Ein aufgezählter Textausrichtungswert. Mögliche Werte finden Sie im Abschnitt Anmerkungen.
Hinweise
Der Parameter nAlign ist eine der folgenden Bearbeitungssteuerelementstile:
ES_LEFT für die linke Ausrichtung
ES_CENTER zur zentrieren Ausrichtung
ES_RIGHT für die rechte Ausrichtung
Weitere Informationen zu diesen Formatvorlagen finden Sie unter Bearbeiten von Steuerelementformatvorlagen.
CMFCRibbonEdit::SetWidth
Legt die Breite des Textfelds für das CMFCRibbonEdit -Steuerelement fest.
void SetWidth(
int nWidth,
BOOL bInFloatyMode = FALSE);
Parameter
nWidth
[in] Die Breite des Textfelds in Pixel.
bInFloatyMode
TRUE, um die Breite für den gleitenden Modus festzulegen; FALSE, um die Breite für den regulären Modus festzulegen.
Hinweise
Das CMFCRibbonEdit Steuerelement verfügt je nach Anzeigemodus über zwei Breiten: gleitender Modus und normaler Modus.
Siehe auch
Hierarchiediagramm
Klassen
CMFCRibbonButton-Klasse
CMFCRibbonBar-Klasse