Udostępnij za pośrednictwem


Klasa CMFCRibbonStatusBarPane

Klasa CMFCRibbonStatusBarPane implementuje element wstążki, który można dodać do paska stanu wstążki.

Składnia

class CMFCRibbonStatusBarPane : public CMFCRibbonButton

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane Tworzy i inicjuje CMFCRibbonStatusBarPane obiekt.

Metody publiczne

Nazwa/nazwisko opis
CMFCRibbonStatusBarPane::GetAlmostLargeText Zwraca ciąg, który definiuje najdłuższy ciąg tekstowy, który można wyświetlić w okienku bez obcinania.
CMFCRibbonStatusBarPane::GetTextAlign Zwraca bieżące ustawienie wyrównania tekstu.
CMFCRibbonStatusBarPane::IsAnimation Określa, czy animacja jest w toku.
CMFCRibbonStatusBarPane::IsExtended Określa, czy okienko znajduje się w rozszerzonym obszarze paska stanu wstążki.
CMFCRibbonStatusBarPane::OnDrawBorder (Przesłonięcia) CMFCRibbonButton::OnDrawBorder.)
CMFCRibbonStatusBarPane::OnFillBackground (Przesłonięcia) CMFCRibbonButton::OnFillBackground.)
CMFCRibbonStatusBarPane::SetAlmostLargeText Definiuje najdłuższy ciąg tekstowy, który można wyświetlić w okienku bez obcinania.
CMFCRibbonStatusBarPane::SetAnimationList Przypisuje do okienka listę obrazów, która może służyć do animacji.
CMFCRibbonStatusBarPane::SetTextAlign Ustawia wyrównanie tekstu.
CMFCRibbonStatusBarPane::StartAnimation Uruchamia animację przypisaną do okienka.
CMFCRibbonStatusBarPane::StopAnimation Zatrzymuje animację przypisaną do okienka. .

Metody chronione

Nazwa/nazwisko opis
CMFCRibbonStatusBarPane::OnFinishAnimation Wywoływana przez platformę, gdy animacja przypisana do okienka zostanie zatrzymana.

Przykład

W poniższym przykładzie pokazano, jak używać różnych metod w CMFCRibbonStatusBarPane klasie . W przykładzie pokazano, jak utworzyć CMFCRibbonStatusBarPane obiekt, ustawić wyrównanie tekstu etykiety okienka paska stanu, zdefiniować najdłuższy tekst, który można wyświetlić w okienku paska stanu bez obcinania, dołączyć do okienka paska stanu listę obrazów, która może być używana do animacji i uruchomić animację.

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();

Hierarchia dziedziczenia

Obiekt CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonStatusBarPane

Wymagania

Nagłówek: afxribbonstatusbarpane.h

CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane

Konstruowanie obiektu okienka na pasku stanu.

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);

Parametry

nCmdID
[in] Określa identyfikator polecenia okienka.

lpszText
[in] Określa ciąg tekstowy, który ma być wyświetlany w okienku.

bIsStatic
[in] Jeśli wartość TRUE, nie można zaznaczyć ani zaznaczyć okienka stanu, klikając je.

hIcon
[in] Określa uchwyt do ikony, która ma być wyświetlana w okienku.

lpszAlmostLargeText
[in] Określa najdłuższy ciąg tekstowy, który może być wyświetlany przez okienko.

hBmpAnimationList
[in] Określa dojście do listy obrazów, która jest używana do animacji.

cxAnimation
[in] Określa szerokość ikony w pikselach na liście obrazów, która jest używana do animacji.

clrTrnsp
[in] Określa przezroczysty kolor obrazów na liście obrazów, które są używane do animacji.

uiAnimationListResID
[in] Określa identyfikator zasobu listy obrazów, która jest używana do animacji.

CMFCRibbonStatusBarPane::GetAlmostLargeText

Pobiera najdłuższy ciąg tekstowy, który może być wyświetlany w okienku paska stanu.

LPCTSTR GetAlmostLargeText() const;

Wartość zwracana

Najdłuższy ciąg tekstowy, który może być wyświetlany w okienku paska stanu.

CMFCRibbonStatusBarPane::GetTextAlign

Pobiera bieżące ustawienie wyrównania tekstu etykiety okienka paska stanu.

int GetTextAlign() const;

Wartość zwracana

Bieżące wyrównanie tekstu, które może być jednym z następujących elementów:

  • TA_LEFT

  • TA_CENTER

  • TA_RIGHT.

CMFCRibbonStatusBarPane::IsAnimation

Określa, czy animacja jest w toku.

BOOL IsAnimation() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli animacja jest w toku; FAŁSZ w przeciwnym razie.

CMFCRibbonStatusBarPane::IsExtended

Ustal, czy okienko znajduje się w rozszerzonym obszarze paska stanu wstążki.

BOOL IsExtended() const;

Wartość zwracana

Wartość TRUE, jeśli okienko znajduje się na pasku stanu, rozszerzony obszar. FAŁSZ w przeciwnym razie.

CMFCRibbonStatusBarPane::OnDrawBorder

Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.

virtual void OnDrawBorder(CDC*);

Parametry

[in] CDC*

Uwagi

CMFCRibbonStatusBarPane::OnFillBackground

Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.

virtual COLORREF OnFillBackground(CDC* pDC);

Parametry

[in] PDC

Wartość zwracana

Uwagi

CMFCRibbonStatusBarPane::OnFinishAnimation

Struktura wywołuje tę metodę po zakończeniu animacji przypisanej do okienka.

virtual void OnFinishAnimation();

Uwagi

StopAnimation metoda wywołuje metodę OnFinishAnimation , której można użyć do czyszczenia danych po zakończeniu animacji.

CMFCRibbonStatusBarPane::SetAlmostLargeText

Zdefiniuj najdłuższy tekst, który można wyświetlić w okienku paska stanu bez obcinania.

void SetAlmostLargeText(LPCTSTR lpszAlmostLargeText);

Parametry

lpszAlmostLargeText
[in] Określa najdłuższy ciąg, który można wyświetlić w okienku paska stanu bez obcinania.

Uwagi

Biblioteka oblicza rozmiar tekstu, który określa lpszAlmostLargeText i odpowiednio zmienia rozmiar okienka. Tekst zostanie obcięty, jeśli nadal nie mieści się w okienku.

CMFCRibbonStatusBarPane::SetAnimationList

Dołącza do okienka paska stanu listę obrazów, która może być używana do animacji.

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);

Parametry

hBmpAnimationList
[in] Określa dojście do listy obrazów.

cxAnimation
[in] Określa szerokość w pikselach ramki na liście obrazów.

clrTransp
[in] Określa przezroczysty kolor listy obrazów.

uiAnimationListResID
[in] Określa identyfikator zasobu listy obrazów.

Wartość zwracana

WARTOŚĆ TRUE, jeśli lista obrazów została pomyślnie dołączona do okienka paska stanu; FAŁSZ w przeciwnym razie.

CMFCRibbonStatusBarPane::SetTextAlign

Ustawia wyrównanie tekstu etykiety okienka paska stanu.

void SetTextAlign(int nAlign);

Parametry

nAlign
[in] Określa wyrównanie tekstu.

Uwagi

nAlign może mieć jedną z następujących wartości:

  • TA_LEFT: wyrównanie po lewej stronie

  • TA_CENTER: wyrównanie do środka

  • TA_RIGHT: wyrównanie do prawej

CMFCRibbonStatusBarPane::StartAnimation

Uruchamia animację przypisaną do okienka.

void StartAnimation(
    UINT nFrameDelay=500,
    UINT nDuration=-1);

Parametry

nFrameDelay
[in] Określa szybkość klatek animacji w milisekundach.

nDuration
[in] Określa czas odtwarzania animacji w milisekundach. Użyj -1 dla pętli nieskończonej.

Uwagi

Przed wywołaniem StartAnimation metody należy określić dojście do listy obrazów przy użyciu polecenia SetAnimationList.

CMFCRibbonStatusBarPane::StopAnimation

Zatrzymuje animację przypisaną do okienka paska stanu.

void StopAnimation();

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCRibbonButton
Klasa CMFCRibbonStatusBar