Condividi tramite

Classe CMFCRibbonStatusBarPane

  • Articolo

La CMFCRibbonStatusBarPane classe implementa un elemento della barra multifunzione che è possibile aggiungere a una barra di stato della barra multifunzione.

Sintassi

class CMFCRibbonStatusBarPane : public CMFCRibbonButton

Membri

Costruttori pubblici

Nome Descrizione
CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane Costruisce e inizializza un oggetto CMFCRibbonStatusBarPane.

Metodi pubblici

Nome Descrizione
CMFCRibbonStatusBarPane::GetAlmostLargeText Restituisce la stringa che definisce la stringa di testo più lunga che può essere visualizzata nel riquadro senza troncamento.
CMFCRibbonStatusBarPane::GetTextAlign Restituisce l'impostazione corrente dell'allineamento del testo.
CMFCRibbonStatusBarPane::IsAnimation Determina se l'animazione è in corso.
CMFCRibbonStatusBarPane::IsExtended Determina se il riquadro si trova nell'area estesa della barra di stato della barra multifunzione.
CMFCRibbonStatusBarPane::OnDrawBorder (sostituzioni )CMFCRibbonButton::OnDrawBorder.
CMFCRibbonStatusBarPane::OnFillBackground (sostituzioni )CMFCRibbonButton::OnFillBackground.
CMFCRibbonStatusBarPane::SetAlmostLargeText Definisce la stringa di testo più lunga che può essere visualizzata nel riquadro senza troncamento.
CMFCRibbonStatusBarPane::SetAnimationList Assegna al riquadro un elenco di immagini che può essere usato per l'animazione.
CMFCRibbonStatusBarPane::SetTextAlign Imposta l'allineamento del testo.
CMFCRibbonStatusBarPane::StartAnimation Avvia l'animazione assegnata al riquadro.
CMFCRibbonStatusBarPane::StopAnimation Arresta l'animazione assegnata al riquadro. .

Metodi protetti

Nome Descrizione
CMFCRibbonStatusBarPane::OnFinishAnimation Chiamato dal framework quando l'animazione assegnata al riquadro si arresta.

Esempio

Nell'esempio seguente viene illustrato come usare vari metodi nella classe CMFCRibbonStatusBarPane. L'esempio mostra come costruire un CMFCRibbonStatusBarPane oggetto, impostare l'allineamento del testo dell'etichetta del riquadro della barra di stato, definire il testo più lungo che può essere visualizzato nel riquadro della barra di stato senza troncamento, allegare al riquadro della barra di stato un elenco di immagini che può essere usato per l'animazione e avviare l'animazione.

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

Gerarchia di ereditarietà

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonStatusBarPane

Requisiti

Intestazione: afxribbonstatusbarpane.h

CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane

Costruire un oggetto riquadro nella barra di stato.

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

Parametri

nCmdID
[in] Specifica l'ID comando del riquadro.

lpszText
[in] Specifica la stringa di testo da visualizzare nel riquadro.

bIsStatic
[in] Se TRUE, il riquadro di stato non può essere evidenziato o selezionato facendo clic su di esso.

hIcon
[in] Specifica un handle per un'icona da visualizzare nel riquadro.

lpszAlmostLargeText
[in] Specifica la stringa di testo più lunga che può essere visualizzata dal riquadro.

hBmpAnimationList
[in] Specifica un handle per un elenco di immagini utilizzato per l'animazione.

cxAnimation
[in] Specifica la larghezza, in pixel, dell'icona nell'elenco di immagini utilizzato per l'animazione.

clrTrnsp
[in] Specifica il colore trasparente delle immagini nell'elenco di immagini utilizzato per l'animazione.

uiAnimationListResID
[in] Specifica un ID risorsa di un elenco di immagini utilizzato per l'animazione.

CMFCRibbonStatusBarPane::GetAlmostLargeText

Ottiene la stringa di testo più lunga che il riquadro della barra di stato può visualizzare.

LPCTSTR GetAlmostLargeText() const;

Valore restituito

Stringa di testo più lunga che il riquadro della barra di stato può visualizzare.

CMFCRibbonStatusBarPane::GetTextAlign

Ottiene l'impostazione corrente dell'allineamento del testo dell'etichetta del riquadro della barra di stato.

int GetTextAlign() const;

Valore restituito

Allineamento del testo corrente che può essere uno dei seguenti:

  • TA_LEFT

  • TA_CENTER

  • TA_RIGHT.

CMFCRibbonStatusBarPane::IsAnimation

Determina se l'animazione è in corso.

BOOL IsAnimation() const;

Valore restituito

TRUE se l'animazione è in corso; FALSE in caso contrario.

CMFCRibbonStatusBarPane::IsExtended

Determinare se il riquadro si trova nell'area estesa della barra di stato della barra multifunzione.

BOOL IsExtended() const;

Valore restituito

TRUE se il riquadro si trova nell'area estesa della barra di stato. FALSE in caso contrario.

CMFCRibbonStatusBarPane::OnDrawBorder

Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

virtual void OnDrawBorder(CDC*);

Parametri

[in] CDC*

Osservazioni:

CMFCRibbonStatusBarPane::OnFillBackground

Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

virtual COLORREF OnFillBackground(CDC* pDC);

Parametri

[in] pDC

Valore restituito

Osservazioni:

CMFCRibbonStatusBarPane::OnFinishAnimation

Framework chiama questo metodo quando termina l'animazione assegnata al riquadro.

virtual void OnFinishAnimation();

Osservazioni:

StopAnimation il metodo chiama il OnFinishAnimation metodo , che è possibile usare per pulire i dati al termine dell'animazione.

CMFCRibbonStatusBarPane::SetAlmostLargeText

Definire il testo più lungo che può essere visualizzato nel riquadro della barra di stato senza troncamento.

void SetAlmostLargeText(LPCTSTR lpszAlmostLargeText);

Parametri

lpszAlmostLargeText
[in] Specifica la stringa più lunga che può essere visualizzata nel riquadro della barra di stato senza troncamento.

Osservazioni:

La libreria calcola le dimensioni del testo che lpszAlmostLargeText specifica e ridimensiona il riquadro di conseguenza. Il testo verrà troncato se non rientra ancora nel riquadro.

CMFCRibbonStatusBarPane::SetAnimationList

Allega al riquadro della barra di stato un elenco di immagini che può essere usato per l'animazione.

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

Parametri

hBmpAnimationList
[in] Specifica un handle per un elenco di immagini.

cxAnimation
[in] Specifica la larghezza, in pixel, del frame nell'elenco di immagini.

clrTransp
[in] Specifica il colore trasparente dell'elenco di immagini.

uiAnimationListResID
[in] Specifica l'ID risorsa dell'elenco di immagini.

Valore restituito

TRUE se l'elenco di immagini è collegato correttamente al riquadro della barra di stato; FALSE in caso contrario.

CMFCRibbonStatusBarPane::SetTextAlign

Imposta l'allineamento del testo dell'etichetta del riquadro della barra di stato.

void SetTextAlign(int nAlign);

Parametri

nAlign
[in] Specifica l'allineamento del testo.

Osservazioni:

nAlign può avere uno dei valori seguenti:

  • TA_LEFT: allineamento a sinistra

  • TA_CENTER: allineamento al centro

  • TA_RIGHT: allineamento a destra

CMFCRibbonStatusBarPane::StartAnimation

Avvia l'animazione assegnata al riquadro.

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

Parametri

nFrameDelay
[in] Specifica la frequenza dei fotogrammi di animazione, espressa in millisecondi.

nDuration
[in] Specifica per quanto tempo riprodurre l'animazione, in millisecondi. Usare -1 per un ciclo infinito.

Osservazioni:

È necessario specificare un handle per un elenco di immagini prima di chiamare StartAnimation tramite SetAnimationList.

CMFCRibbonStatusBarPane::StopAnimation

Arresta l'animazione assegnata al riquadro della barra di stato.

void StopAnimation();

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCRibbonButton
Classe CMFCRibbonStatusBar