Partager via


CProgressCtrl::SetState

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

int SetState(
    int iState
);

Paramètres

Paramètre

Description

[in] iState

Le rapport pour définir la barre de progression. Utilisez l'une des valeurs suivantes :

Valeur

État

PBST_NORMAL

En cours

PBST_ERROR

Erreur

PBST_PAUSED

Suspendu

Valeur de retour

l'état précédent du contrôle de barre de progression actuel.

Notes

Cette méthode envoie le message de PBM_SETSTATE , qui est décrit dans Kit 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 pour la 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 définit l'état du contrôle de barre de progression actuel en pause ou à en cours.

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

Voir aussi

Référence

CProgressCtrl, classe

Graphique de la hiérarchie

À l'aide de CProgressCtrl

PBM_SETSTATE

CProgressCtrl::GetState