Share via


CProgressCtrl::SetState

Establece el estado del control actual de barra de progreso.

int SetState(
    int iState
);

Parámetros

Parámetro

Descripción

[in] iState

El estado para establecer la barra de progreso.Utilice uno de los siguientes valores:

ValorEstado
PBST_NORMAL En curso
PBST_ERROR Error
PBST_PAUSED En pausa

Valor devuelto

El estado anterior del control actual de la barra de progreso.

Comentarios

este método envía el mensaje de PBM_SETSTATE , que se describe en Windows SDK.

Requisitos

encabezado: afxcmn.h

Este control se admite en Windows Vista y posterior.

los requisitos adicionales para este método se describen en Requisitos de la compilación para Controles comunes de Windows Vista.

Ejemplo

El ejemplo de código siguiente se define la variable, m_progressCtrl, que se utiliza para obtener acceso mediante programación al control de barra de progreso.esta variable se utiliza en el ejemplo siguiente.

    // Variable to access the progress control
    CProgressCtrl m_progressCtrl;

El ejemplo de código siguiente establece el estado del control actual de barra de progreso a en pausa o en curso.

// Set the progrees control to normal or paused state.
void CCProgressCtrl_s1Dlg::OnSetstateNormal()
{
    m_progressCtrl.SetState(PBST_NORMAL);
}

void CCProgressCtrl_s1Dlg::OnSetstatePaused()
{
    m_progressCtrl.SetState(PBST_PAUSED);
}

Vea también

Referencia

Clase de CProgressCtrl

Gráfico de jerarquía

Mediante CProgressCtrl

PBM_SETSTATE

CProgressCtrl::GetState