Partager via


CProgressCtrl::GetState

Obtient l'état du contrôle de barre de progression actuel.

int GetState() const;

Valeur de retour

l'état du contrôle de barre de progression actuel, qui est l'une des valeurs suivantes :

Valeur

État

PBST_NORMAL

En cours

PBST_ERROR

Erreur

PBST_PAUSED

Suspendu

Notes

Cette méthode envoie le message de PBM_GETSTATE , qui est décrit dansKit de développement logiciel Windows.

Configuration requise

en-tête : afxcmn.h

Ce contrôle est pris en charge dans Windows Vista et versions ultérieures.

Les spécifications supplémentaires pour cette méthode sont décrites dans Spécifications de génération des contrôles communs Windows Vista.

Exemple

L'exemple de code suivant définit la variable, m_progressCtrl, qui est utilisée pour accéder par programme le contrôle de barre de progression.Cette variable est utilisée dans l'exemple suivant.

    // Variable to access the progress control
    CProgressCtrl m_progressCtrl;

l'exemple de code suivant extrait l'état du contrôle de barre de progression actuel.

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

Voir aussi

Référence

Classe de CProgressCtrl

Graphique de la hiérarchie

Utilisation CProgressCtrl

PBM_GETSTATE

CProgressCtrl::SetState