Compartir por

Clase CMFCRibbonProgressBar

  • Artigo

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

CObject

CMFCRibbonBaseElement

CMFCRibbonProgressBar

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)