CProgressCtrl::GetState
Ruft den Zustand des aktuellen Statusanzeige-Steuerelements ab.
int GetState() const;
Rückgabewert
Der Zustand des aktuellen Statusanzeige-Steuerelements, das einer der folgenden Werte ist:
Wert |
Zustand |
|---|---|
PBST_NORMAL |
In Bearbeitung |
PBST_ERROR |
Fehler |
PBST_PAUSED |
Paused |
Hinweise
Diese Methode sendet die PBM_GETSTATE 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 ab.
// 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);