CProgressCtrl::SetState

Artigo
06/10/2015

Define o estado atual do controle de barra de progresso.

int SetState(
    int iState
);

Parâmetros

[in] iState

O estado para definir a barra de progresso. Use um dos seguintes valores:

Valor	Estado
PBST_NORMAL	Em andamento
PBST_ERROR	Erro
PBST_PAUSED	Em pausa

Valor de retorno

O estado anterior do controle atual de barra de progresso.

Comentários

Este método envia a mensagem de PBM_SETSTATE , que é descrita em Windows SDK.

Requisitos

Cabeçalho: afxcmn.h

Esse controle é suportado em Windows Vista e posteriormente.

Os requisitos adicionais para o método são descritos em Requisitos de compilação para controles comuns do Windows Vista.

Exemplo

O exemplo de código a seguir define a variável, m_progressCtrl, que é usada para acessar por programação o controle de barra de progresso. Esta variável é usado no exemplo a seguir.

    // Variable to access the progress control
    CProgressCtrl m_progressCtrl;

O exemplo de código a seguir define o estado atual do controle de barra de progresso a pausado ou um em andamento.

// 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);
}