Classe CMFCRibbonProgressBar
Implementa un controllo che indica visivamente lo stato di avanzamento di un'operazione di lunga durata.
Sintassi
class CMFCRibbonProgressBar : public CMFCRibbonBaseElement
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CMFCRibbonProgressBar::CMFCRibbonProgressBar | Costruisce e inizializza un oggetto CMFCRibbonProgressBar. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CMFCRibbonProgressBar::GetPos | Restituisce lo stato di avanzamento corrente. |
| CMFCRibbonProgressBar::GetRangeMax | Restituisce il valore massimo dell'intervallo corrente. |
| CMFCRibbonProgressBar::GetRangeMin | Restituisce il valore minimo dell'intervallo corrente. |
| CMFCRibbonProgressBar::GetRegularSize | Restituisce la dimensione regolare dell'elemento della barra multifunzione. (sostituzioni )CMFCRibbonBaseElement::GetRegularSize. |
| CMFCRibbonProgressBar::IsInfiniteMode | Specifica se l'indicatore di stato funziona in modalità infinita. |
| CMFCRibbonProgressBar::OnDraw | Chiamato dal framework per disegnare l'elemento della barra multifunzione. (sostituzioni )CMFCRibbonBaseElement::OnDraw. |
| CMFCRibbonProgressBar::SetInfiniteMode | Imposta l'indicatore di stato per funzionare in modalità infinita. |
| CMFCRibbonProgressBar::SetPos | Imposta lo stato di avanzamento corrente. |
| CMFCRibbonProgressBar::SetRange | Imposta i valori minimo e massimo. |
Osservazioni:
Un CMFCRibbonProgressBar può operare in due modalità: regolare e infinita. In modalità regolare, la barra di stato viene riempita da sinistra a destra e si arresta quando raggiunge il valore massimo. In modalità infinita, la barra di stato viene riempita ripetutamente dal valore minimo al valore massimo. È possibile usare la modalità infinita per indicare che un'operazione è in corso, ma che il tempo di completamento è sconosciuto.
Esempio
L'esempio seguente illustra come usare i vari metodi nella classe CMFCRibbonProgressBar . Nell'esempio viene illustrato come impostare l'indicatore di stato per funzionare in modalità infinita (in cui l'ora di completamento di un'operazione è sconosciuta), impostare i valori minimo e massimo per l'indicatore di stato e impostare la posizione corrente dell'indicatore di stato. Questo frammento di codice fa parte dell'esempio demo di MS Office 2007.
// int cxProgress
// BOOL m_bInfiniteProgressMode
CMFCRibbonProgressBar *pProgressBar = new CMFCRibbonProgressBar(ID_STATUSBAR_PROGRESS, cxProgress);
pProgressBar->SetInfiniteMode(m_bInfiniteProgressMode);
pProgressBar->SetRange(0, 200);
pProgressBar->SetPos(200, true);
Gerarchia di ereditarietà
Requisiti
Intestazione: afxRibbonProgressBar.h
CMFCRibbonProgressBar::CMFCRibbonProgressBar
Costruisce e inizializza un oggetto CMFCRibbonProgressBar .
CMFCRibbonProgressBar();
CMFCRibbonProgressBar(
UINT nID,
int nWidth = 90,
int nHeight = 22);
Parametri
nID
[in] Specifica l'ID comando per la barra di stato della barra multifunzione.
nWidth
[in] Specifica la larghezza, espressa in pixel, della barra di stato della barra multifunzione.
nHeight
[in] Specifica l'altezza, in pixel, della barra di stato della barra multifunzione.
CMFCRibbonProgressBar::GetPos
Restituisce la posizione corrente della barra di stato.
int GetPos () const;
Valore restituito
Valore che rappresenta la posizione corrente dell'indicatore di stato.
Osservazioni:
L'intervallo impostato deve essere compreso nell'intervallo specificato dal metodo CMFCRibbonProgressBar::SetRange .
CMFCRibbonProgressBar::GetRangeMax
Restituisce il valore massimo corrente dell'indicatore di stato.
int GetRangeMax() const;
Valore restituito
Valore massimo dell'intervallo corrente.
Osservazioni:
CMFCRibbonProgressBar::GetRangeMin
Restituisce il valore dell'intervallo minimo corrente dell'indicatore di stato.
int GetRangeMin() const;
Valore restituito
Valore minimo dell'intervallo corrente.
CMFCRibbonProgressBar::GetRegularSize
Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.
virtual CSize GetRegularSize(CDC* pDC);
Parametri
[in] pDC
Valore restituito
Osservazioni:
CMFCRibbonProgressBar::IsInfiniteMode
Specifica se l'indicatore di stato funziona in modalità infinita.
BOOL IsInfiniteMode() const;
Valore restituito
TRUE se l'indicatore di stato è in modalità infinita; in caso contrario, FALSE.
Osservazioni:
In modalità infinita, la barra di stato si riempie ripetutamente dal valore minimo al valore massimo. È possibile usare la modalità infinita per indicare che un'operazione è in corso, ma che il tempo di completamento è sconosciuto.
CMFCRibbonProgressBar::OnDraw
Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.
virtual void OnDraw(CDC* pDC);
Parametri
[in] pDC
Osservazioni:
CMFCRibbonProgressBar::SetInfiniteMode
Imposta l'indicatore di stato per funzionare in modalità infinita.
void SetInfiniteMode(BOOL bSet = TRUE);
Parametri
bSet
[in] TRUE per specificare che l'indicatore di stato è in modalità infinita; in caso contrario, FALSE.
Osservazioni:
In genere, se l'indicatore di stato è in modalità infinita, indica all'utente che un'operazione è in corso, ma che l'ora di completamento è sconosciuta. Pertanto, la barra di stato si riempie ripetutamente dal valore minimo al valore massimo.
CMFCRibbonProgressBar::SetPos
Imposta la posizione corrente della barra di stato.
void SetPos(
int nPos,
BOOL bRedraw = TRUE);
Parametri
nPos
[in] Specifica la posizione in cui è impostata l'indicatore di stato.
bRedraw
[in] Specifica se l'indicatore di stato deve essere ridisegnato.
Osservazioni:
L'intervallo impostato deve essere compreso nell'intervallo specificato dal metodo CMFCRibbonProgressBar::SetRange .
CMFCRibbonProgressBar::SetRange
Imposta i valori minimo e massimo per la barra di stato.
void SetRange(
int nMin,
int nMax);
Parametri
nMin
[in] Specifica il valore minimo dell'intervallo.
nMax
[in] Specifica il valore massimo dell'intervallo.
Osservazioni:
Utilizzare questo metodo per definire l'intervallo della barra di stato impostando i valori minimo e massimo.
Vedi anche
Grafico della gerarchia
Classi
Classe CMFCRibbonBaseElement
Classe CMFCRibbonBar