CMFCRibbonStatusBarPane-Klasse
Die CMFCRibbonStatusBarPane Klasse implementiert ein Menübandelement, das Sie einer Menüband-Statusleiste hinzufügen können.
Syntax
class CMFCRibbonStatusBarPane : public CMFCRibbonButton
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane | Erstellt und initialisiert ein CMFCRibbonStatusBarPane-Objekt. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CMFCRibbonStatusBarPane::GetAlmostLargeText | Gibt die Zeichenfolge zurück, die die längste Textzeichenfolge definiert, die im Bereich ohne Abkürzung angezeigt werden kann. |
| CMFCRibbonStatusBarPane::GetTextAlign | Gibt die aktuelle Einstellung der Textausrichtung zurück. |
| CMFCRibbonStatusBarPane::IsAnimation | Bestimmt, ob die Animation ausgeführt wird. |
| CMFCRibbonStatusBarPane::IsExtended | Bestimmt, ob sich der Bereich im erweiterten Bereich der Statusleiste des Menübands befindet. |
| CMFCRibbonStatusBarPane::OnDrawBorder | (Außerkraftsetzungen CMFCRibbonButton::OnDrawBorder.) |
| CMFCRibbonStatusBarPane::OnFillBackground | (Außerkraftsetzungen CMFCRibbonButton::OnFillBackground.) |
| CMFCRibbonStatusBarPane::SetAlmostLargeText | Definiert die längste Textzeichenfolge, die im Bereich ohne Abschneiden angezeigt werden kann. |
| CMFCRibbonStatusBarPane::SetAnimationList | Weist dem Bereich eine Bildliste zu, die für animationen verwendet werden kann. |
| CMFCRibbonStatusBarPane::SetTextAlign | Legt die Textausrichtung fest. |
| CMFCRibbonStatusBarPane::StartAnimation | Startet die Animation, die dem Bereich zugewiesen ist. |
| CMFCRibbonStatusBarPane::StopAnimation | Beendet die Animation, die dem Bereich zugewiesen ist. . |
Geschützte Methoden
| Name | Beschreibung |
|---|---|
| CMFCRibbonStatusBarPane::OnFinishAnimation | Wird vom Framework aufgerufen, wenn die Animation, die dem Bereich zugewiesen ist, beendet wird. |
Beispiel
Im folgenden Beispiel wird die Verwendung der unterschiedlichen Methoden in der CMFCRibbonStatusBarPane-Klasse veranschaulicht. Das Beispiel zeigt, wie Sie ein CMFCRibbonStatusBarPane Objekt erstellen, die Textausrichtung der Beschriftung des Statusleistenbereichs festlegen, den längsten Text definieren, der im Statusleistenbereich ohne Abkürzung angezeigt werden kann, dem Statusleistenbereich eine Bildliste anfügen, die für animationen verwendet werden kann, und die Animation starten.
CString strTitlePane1;
CString strTitlePane2;
strTitlePane1.LoadString(IDS_STATUS_PANE1);
strTitlePane2.LoadString(IDS_STATUS_PANE2);
CMFCRibbonStatusBarPane* rsbp = new CMFCRibbonStatusBarPane( ID_STATUSBAR_PANE1, strTitlePane1, TRUE );
rsbp->SetTextAlign( TA_CENTER );
rsbp->SetAlmostLargeText( _T( "Status bar" ) );
CBitmap bitmap;
bitmap.LoadBitmapW( IDB_FILESMALL );
rsbp->SetAnimationList( (HBITMAP)bitmap );
rsbp->StartAnimation();
Vererbungshierarchie
Anforderungen
Kopfzeile: afxribbonstatusbarpane.h
CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane
Erstellen Sie ein Bereichsobjekt in der Statusleiste.
CMFCRibbonStatusBarPane(
UINT nCmdID,
LPCTSTR lpszText,
BOOL bIsStatic=FALSE,
HICON hIcon=NULL,
LPCTSTR lpszAlmostLargeText=NULL);
CMFCRibbonStatusBarPane(
UINT nCmdID,
LPCTSTR lpszText,
HBITMAP hBmpAnimationList,
int cxAnimation=16,
COLORREF clrTrnsp=RGB(192,192 1,192) 1,
HICON hIcon=NULL,
BOOL bIsStatic=FALSE);
CMFCRibbonStatusBarPane(
UINT nCmdID,
LPCTSTR lpszText,
UINT uiAnimationListResID,
int cxAnimation=16,
COLORREF clrTrnsp=RGB(192, 192 1, 192) 1,
HICON hIcon=NULL,
BOOL bIsStatic=FALSE);
Parameter
nCmdID
[in] Gibt die Befehls-ID des Bereichs an.
lpszText
[in] Gibt die Textzeichenfolge an, die im Bereich angezeigt werden soll.
bIsStatic
[in] Wenn TRUE, kann der Statusbereich nicht hervorgehoben oder ausgewählt werden, indem er darauf klickt.
hIcon
[in] Gibt ein Handle für ein Symbol an, das im Bereich angezeigt werden soll.
lpszAlmostLargeText
[in] Gibt die längste Textzeichenfolge an, die vom Bereich angezeigt werden kann.
hBmpAnimationList
[in] Gibt ein Handle für eine Bildliste an, die für animationen verwendet wird.
cxAnimation
[in] Gibt die Breite des Symbols in der Bildliste in Pixel an, das für die Animation verwendet wird.
clrTrnsp
[in] Gibt die transparente Farbe von Bildern in der Bildliste an, die für die Animation verwendet werden.
uiAnimationListResID
[in] Gibt eine Ressourcen-ID einer Bildliste an, die für die Animation verwendet wird.
CMFCRibbonStatusBarPane::GetAlmostLargeText
Ruft die längste Textzeichenfolge ab, die der Statusleistenbereich anzeigen kann.
LPCTSTR GetAlmostLargeText() const;
Rückgabewert
Die längste Textzeichenfolge, die im Statusleistenbereich angezeigt werden kann.
CMFCRibbonStatusBarPane::GetTextAlign
Ruft die aktuelle Einstellung der Textausrichtung der Beschriftung des Statusleistenbereichs ab.
int GetTextAlign() const;
Rückgabewert
Die aktuelle Textausrichtung, die eine der folgenden Sein kann:
TA_LEFT
TA_CENTER
TA_RIGHT.
CMFCRibbonStatusBarPane::IsAnimation
Bestimmt, ob die Animation ausgeführt wird.
BOOL IsAnimation() const;
Rückgabewert
TRUE, wenn die Animation ausgeführt wird; Andernfalls FALSE.
CMFCRibbonStatusBarPane::IsExtended
Bestimmen Sie, ob sich der Bereich im erweiterten Bereich der Statusleiste des Menübands befindet.
BOOL IsExtended() const;
Rückgabewert
TRUE, wenn sich der Bereich im erweiterten Bereich der Statusleiste befindet. Andernfalls FALSE.
CMFCRibbonStatusBarPane::OnDrawBorder
Weitere Details finden Sie im Quellcode im Ordner VC\atlmfc\src\mfc Ihrer Visual Studio-Installation.
virtual void OnDrawBorder(CDC*);
Parameter
[in] CDC*
Hinweise
CMFCRibbonStatusBarPane::OnFillBackground
Weitere Details finden Sie im Quellcode im Ordner VC\atlmfc\src\mfc Ihrer Visual Studio-Installation.
virtual COLORREF OnFillBackground(CDC* pDC);
Parameter
[in] Pdc
Rückgabewert
Bemerkungen
CMFCRibbonStatusBarPane::OnFinishAnimation
Framework ruft diese Methode auf, wenn die Animation, die dem Bereich zugewiesen ist, beendet wird.
virtual void OnFinishAnimation();
Hinweise
StopAnimationdie Methode ruft die Methode auf, mit der OnFinishAnimation Sie Daten sauber können, wenn die Animation endet.
CMFCRibbonStatusBarPane::SetAlmostLargeText
Definieren Sie den längsten Text, der im Statusleistenbereich ohne Abschneiden angezeigt werden kann.
void SetAlmostLargeText(LPCTSTR lpszAlmostLargeText);
Parameter
lpszAlmostLargeText
[in] Gibt die längste Zeichenfolge an, die im Statusleistenbereich ohne Abkürzung angezeigt werden kann.
Hinweise
Die Bibliothek berechnet die Größe von Text, den lpszAlmostLargeText angibt, und ändert die Größe des Bereichs entsprechend. Der Text wird abgeschnitten, wenn er immer noch nicht in den Bereich passt.
CMFCRibbonStatusBarPane::SetAnimationList
Fügt an den Statusleistenbereich eine Bildliste an, die für die Animation verwendet werden kann.
void SetAnimationList(
HBITMAP hBmpAnimationList,
int cxAnimation=16,
COLORREF clrTransp=RGB(192, 192 1, 192) 1);
BOOL SetAnimationList(
UINT uiAnimationListResID,
int cxAnimation=16,
COLORREF clrTransp=RGB(192, 192 1, 192) 1);
Parameter
hBmpAnimationList
[in] Gibt ein Handle für eine Bildliste an.
cxAnimation
[in] Gibt die Breite des Rahmens in der Bildliste in Pixel an.
clrTransp
[in] Gibt die transparente Farbe der Bildliste an.
uiAnimationListResID
[in] Gibt die Ressourcen-ID der Bildliste an.
Rückgabewert
TRUE, wenn die Bildliste erfolgreich an den Statusleistenbereich angefügt wird; Andernfalls FALSE.
CMFCRibbonStatusBarPane::SetTextAlign
Legt die Textausrichtung der Beschriftung des Statusleistenbereichs fest.
void SetTextAlign(int nAlign);
Parameter
nAlign
[in] Gibt die Textausrichtung an.
Hinweise
nAlign kann einen der folgenden Werte aufweisen:
TA_LEFT: linksbündige Ausrichtung
TA_CENTER: Zentrieren der Ausrichtung
TA_RIGHT: Rechtsausrichtung
CMFCRibbonStatusBarPane::StartAnimation
Startet die Animation, die Sie dem Bereich zuweisen.
void StartAnimation(
UINT nFrameDelay=500,
UINT nDuration=-1);
Parameter
nFrameDelay
[in] Gibt die Animationsframerate in Millisekunden an.
nDuration
[in] Gibt an, wie lange die Animation in Millisekunden wiedergegeben werden soll. Verwenden Sie -1 für eine Endlosschleife.
Hinweise
Sie müssen ein Handle für eine Bildliste angeben, bevor Sie mit der Verwendung SetAnimationListanrufenStartAnimation.
CMFCRibbonStatusBarPane::StopAnimation
Beendet die Animation, die Sie dem Statusleistenbereich zugewiesen haben.
void StopAnimation();
Siehe auch
Hierarchiediagramm
Klassen
CMFCRibbonButton-Klasse
CMFCRibbonStatusBar-Klasse
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für