Classe CMFCRibbonStatusBarPane
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à
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