IActionProgress-Schnittstelle (shobjidl_core.h)

Stellt die abstrakte Basisklasse dar, von der fortschrittsgesteuerte Vorgänge erben können.

Vererbung

Die IActionProgress-Schnittstelle erbt von der IUnknown-Schnittstelle . IActionProgress verfügt auch über folgende Arten von Membern:

Methoden

Die IActionProgress-Schnittstelle verfügt über diese Methoden.

IActionProgress::Begin Wird aufgerufen, wenn eine Aktion gestartet wurde, für die der Fortschritt für den Benutzer angezeigt werden muss.
IActionProgress::End Gibt an, dass die dieser Statusimplementierung zugeordnete Aktion beendet wurde.
IActionProgress::QueryCancel Stellt Informationen dazu bereit, ob die Aktion abgebrochen wird.
IActionProgress::ResetCancel Setzt das Statusdialogfeld zurück, nachdem ein Abbruch abgeschlossen wurde.
IActionProgress::UpdateProgress Updates den Fortschritt einer Aktion auf der Benutzeroberfläche.
IActionProgress::UpdateText Wird aufgerufen, wenn der Der Aktion zugeordneter beschreibender Text geändert wird.

Hinweise

Diese Klasse ist eine abstrakte Klasse, die möglicherweise nicht instanziiert wird. Es stellt ein Framework bereit, das abgeleitete Klassen verwenden können, um einen Statusrückruf zu implementieren. Dieser Rückruf kann von Anwendungen verwendet werden, um den Status von Aktionen an die Benutzeroberfläche zu melden. Hier bezieht sich "Aktionen" auf Vorgänge, die einen erheblichen Zeitraum in Anspruch nehmen können, z. B. das Herunterladen oder Kopieren von Dateien, und während denen eine sichtbare Statusanzeige geeignet wäre.

Anwendungen implementieren diese Schnittstelle in der Regel nicht. Ein Großteil der Funktionen, mit denen Benutzer während Aktionen interagieren, wird von der CProgressDialog-Klasse (CLSID_ProgressDialog) bereitgestellt, die IActionProgress implementiert und den Fortschritt in einem Dialogfeld anzeigt. Wenn eine Lösung erforderlich ist, die einen anderen Mechanismus als ein Dialogfeld erfordert, kann IActionProgress verwendet werden, um grundlegende Statusanzeigefunktionen bereitzustellen.

Nach der Implementierung sollten Klassen IActionProgress::Begin aufrufen, wenn eine Aktion gestartet wird. In regelmäßigen Abständen sollte IActionProgress::UpdateProgress aufgerufen werden, um die Benutzeroberfläche mit Statusinformationen zu aktualisieren, und detaillierte Textinformationen sollten der Benutzeroberfläche durch Aufrufen von IActionProgress::UpdateText übermittelt werden. IActionProgress::QueryCancel und IActionProgress::ResetCancel sollten aufgerufen werden, um Abbruchanforderungen zu verarbeiten. Nach Abschluss des Vorgangs sollte IActionProgress::End aufgerufen werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)

Weitere Informationen

IProgressDialog