CProgressCtrl::GetState
Obtém o estado atual do controle de barra de progresso.
int GetState() const;
Valor de retorno
O estado atual do controle de barra de progresso, que é um dos seguintes valores:
Valor |
Estado |
|---|---|
PBST_NORMAL |
Em andamento |
PBST_ERROR |
Erro |
PBST_PAUSED |
Em pausa |
Comentários
Este método envia a mensagem de PBM_GETSTATE , que é descrita emWindows 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 recupera o estado atual do controle de barra de progresso.
// Display the current state of the progress control.
CString str = _T("The progress control state is ");
int progState = m_progressCtrl.GetState();
if (progState == PBST_NORMAL)
str += _T("NORMAL");
else if (progState == PBST_PAUSED)
str += _T("PAUSED");
else if (progState == PBST_ERROR)
str += _T("ERROR");
else
str += _T("unknown");
AfxMessageBox(str, MB_ICONEXCLAMATION);