Partilhar via


CProgressCtrl::SetState

Define o estado atual do controle de barra de progresso.

int SetState(
    int iState
);

Parâmetros

Parâmetro

Descrição

[in] iState

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

ValorEstado
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 Criar requisitos de 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);
}

Consulte também

Referência

Classe de CProgressCtrl

Gráfico de hierarquia

Usando CProgressCtrl

PBM_SETSTATE

CProgressCtrl::GetState