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

Öffentliche Methoden

Geschützte Methoden

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

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonStatusBarPane

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

Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

virtual void OnDrawBorder(CDC*);

Parameter

[in] CDC*

Hinweise

CMFCRibbonStatusBarPane::OnFillBackground

Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der 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

StopAnimation -Methode ruft die Methode auf, mit der OnFinishAnimation Sie Daten bereinigen 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