Freigeben über


CProgressCtrl::SetState

Legt den Zustand des aktuellen Statusanzeige-Steuerelements fest.

int SetState(
    int iState
);

Parameter

Parameter

Description

[in] iState

Der Zustand, um der Statusanzeige festzulegen. Verwenden Sie einen der folgenden Werte:

Wert

Zustand

PBST_NORMAL

In Bearbeitung

PBST_ERROR

Fehler

PBST_PAUSED

Paused

Rückgabewert

Der vorherige Zustand des aktuellen Statusanzeige-Steuerelements.

Hinweise

Diese Methode sendet die PBM_SETSTATE Meldung, die im Windows SDK beschrieben wird.

Anforderungen

Header: afxcmn.h

Dieses Steuerelement wird in Windows Vista und höher unterstützt.

Zusätzliche Anforderungen für diese Methode werden in Anforderungen für die Erstellung von Windows Vista-Standardsteuerelementen beschrieben.

Beispiel

Im folgenden Codebeispiel wird die Variable, m_progressCtrl, die verwendet wird, um auf das Statusanzeige-Steuerelement programmgesteuert zuzugreifen. Diese Variable wird im folgenden Beispiel verwendet.

    // Variable to access the progress control
    CProgressCtrl m_progressCtrl;

Im folgenden Codebeispiel wird der Zustand des aktuellen Statusanzeige-Steuerelements zu angehaltenem oder zu laufendem fest.

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

Siehe auch

Referenz

CProgressCtrl-Klasse

Hierarchiediagramm

Verwenden von CProgressCtrl

PBM_SETSTATE

CProgressCtrl::GetState