CProgressCtrl::SetState

Artigo
08/25/2010

Define o estado do corrente BAR de progresso controle.

int SetState(
        int iState
);

Parâmetros

Parâmetro	Descrição
[in] iState	O estado para conjunto o BAR de progresso.Use um dos seguintes valores: Valor Estado PBST_NORMAL Em andamento PBST_ERROR Erro PBST_PAUSED Em pausa

[in] iState

O estado para conjunto o BAR 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 corrente BAR de progresso controle.

Comentários

Esse método envia o PBM_SETSTATE mensagem, que é descrita no Windows SDK.

Requisitos

Cabeçalho: afxcmn.h

Este controle é suportado no Windows Vista e mais recente.

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

Exemplo

O exemplo de código a seguir define a variável, m_progressCtrl, que é usado para acessar programaticamente o BAR de progresso controle. Essa variável é usada no exemplo a seguir.

 // Variable to access the progress control
    CProgressCtrl m_progressCtrl;

O exemplo de código a seguir define o estado do controle de BAR de andamento corrente para pausado ou 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);
}