Clase CMFCRibbonProgressBar
Implementa un control que indica visualmente el progreso de una operación larga.
Sintaxis
class CMFCRibbonProgressBar : public CMFCRibbonBaseElement
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| CMFCRibbonProgressBar::CMFCRibbonProgressBar | Construye e inicializa un objeto CMFCRibbonProgressBar. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| CMFCRibbonProgressBar::GetPos | Devuelve el progreso actual. |
| CMFCRibbonProgressBar::GetRangeMax | Devuelve el valor máximo del intervalo actual. |
| CMFCRibbonProgressBar::GetRangeMin | Devuelve el valor mínimo del intervalo actual. |
| CMFCRibbonProgressBar::GetRegularSize | Devuelve el tamaño normal del elemento de la cinta. (Invalida CMFCRibbonBaseElement::GetRegularSize.) |
| CMFCRibbonProgressBar::IsInfiniteMode | Especifica si la barra de progreso funciona en modo infinito. |
| CMFCRibbonProgressBar::OnDraw | Llamado por el marco de trabajo para dibujar el elemento de la cinta. (Invalida CMFCRibbonBaseElement::OnDraw.) |
| CMFCRibbonProgressBar::SetInfiniteMode | Establece la barra de progreso para que funcione en modo infinito. |
| CMFCRibbonProgressBar::SetPos | Establece el progreso actual. |
| CMFCRibbonProgressBar::SetRange | Establece los valores mínimo y máximo. |
Comentarios
Un CMFCRibbonProgressBar puede funcionar en dos modos: normal e infinito. En el modo normal, la barra de progreso se rellena de izquierda a derecha y se detiene cuando alcanza el valor máximo. En el modo infinito, la barra de progreso se rellena repetidamente desde el valor mínimo al máximo. Puede usar el modo infinito para indicar que una operación está en curso, pero que se desconoce el tiempo de finalización.
Ejemplo
En el siguiente ejemplo se muestra cómo usar los distintos métodos en la clase CMFCRibbonProgressBar . En el ejemplo se muestra cómo establecer la barra de progreso para que funcione en modo infinito (en el que se desconoce el tiempo de finalización de una operación), establecer los valores mínimo y máximo de la barra de progreso y la posición actual de la barra de progreso. Este fragmento de código forma parte del ejemplo de demostración de 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);
Jerarquía de herencia
Requisitos
Encabezado: afxRibbonProgressBar.h
CMFCRibbonProgressBar::CMFCRibbonProgressBar
Construye e inicializa un objeto CMFCRibbonProgressBar.
CMFCRibbonProgressBar();
CMFCRibbonProgressBar(
UINT nID,
int nWidth = 90,
int nHeight = 22);
Parámetros
Nid
[in] Especifica el identificador de comando de la barra de progreso de la cinta de opciones.
nWidth
[in] Especifica el ancho, en píxeles, de la barra de progreso de la cinta de opciones.
nHeight
[in] Especifica la altura, en píxeles, de la barra de progreso de la cinta de opciones.
CMFCRibbonProgressBar::GetPos
Devuelve la posición actual de la barra de progreso.
int GetPos () const;
Valor devuelto
Un valor que representa la posición actual de la barra de progreso.
Comentarios
El intervalo que se establece debe estar dentro del intervalo especificado mediante el método CMFCRibbonProgressBar::SetRange.
CMFCRibbonProgressBar::GetRangeMax
Devuelve el valor máximo actual de la barra de progreso.
int GetRangeMax() const;
Valor devuelto
El valor máximo del intervalo actual.
Comentarios
CMFCRibbonProgressBar::GetRangeMin
Devuelve el valor de intervalo mínimo actual de la barra de progreso.
int GetRangeMin() const;
Valor devuelto
El valor mínimo del intervalo actual.
CMFCRibbonProgressBar::GetRegularSize
Para obtener información más detallada, consulta el código fuente que se ubica en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.
virtual CSize GetRegularSize(CDC* pDC);
Parámetros
[in] pDC
Valor devuelto
Comentarios
CMFCRibbonProgressBar::IsInfiniteMode
Especifica si la barra de progreso funciona en modo infinito.
BOOL IsInfiniteMode() const;
Valor devuelto
TRUE si la barra de progreso está en modo infinito; de lo contrario, FALSE.
Comentarios
En el modo infinito, la barra de progreso se rellena repetidamente desde el valor mínimo al máximo. Puede usar el modo infinito para indicar que una operación está en curso, pero que se desconoce el tiempo de finalización.
CMFCRibbonProgressBar::OnDraw
Para obtener información más detallada, consulta el código fuente que se ubica en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.
virtual void OnDraw(CDC* pDC);
Parámetros
[in] pDC
Comentarios
CMFCRibbonProgressBar::SetInfiniteMode
Establece la barra de progreso para que funcione en modo infinito.
void SetInfiniteMode(BOOL bSet = TRUE);
Parámetros
bSet
[in] TRUE para especificar que la barra de progreso está en modo infinito; de lo contrario, FALSE.
Comentarios
Normalmente, si la barra de progreso está en modo infinito, indica al usuario que una operación está en curso, pero que se desconoce el tiempo de finalización. Por lo tanto, la barra de progreso se rellena repetidamente desde el valor mínimo al máximo.
CMFCRibbonProgressBar::SetPos
Establece la posición actual de la barra de progreso.
void SetPos(
int nPos,
BOOL bRedraw = TRUE);
Parámetros
nPos
[in] Especifica la posición en la que se ha establecido la barra de progreso.
bRedraw
[in] Especifica si se debe volver a dibujar la barra de progreso.
Comentarios
El intervalo que se establece debe estar dentro del intervalo especificado mediante el método CMFCRibbonProgressBar::SetRange.
CMFCRibbonProgressBar::SetRange
Establece los valores mínimo y máximo de la barra de progreso.
void SetRange(
int nMin,
int nMax);
Parámetros
nMin
Especifica el valor mínimo del intervalo.
nMax
Especifica el valor máximo del intervalo.
Comentarios
Use este método para definir el intervalo de la barra de progreso mediante el establecimiento de los valores mínimo y máximo.
Consulte también
Gráfico de jerarquías
Clases
CMFCRibbonBaseElement (clase)
CMFCRibbonBar (clase)