Triggerschnittstellen

Die APIs, die zum Verwalten von Triggern verwendet werden, variieren je nach Version des Taskplaner. In beiden Fällen ermöglichen ihnen diese APIs jedoch das Erstellen neuer Trigger, das Abrufen und Aktualisieren vorhandener Trigger und das Löschen von Triggern, die nicht mehr benötigt werden.

Anwendungen, die mit Taskplaner 2.0 entwickelt werden, können Objekte und Schnittstellen verwenden, um die Trigger für eine Aufgabe zu erstellen, abzurufen, zu ändern und zu löschen.

In der folgenden Abbildung gibt eine Aufgabe eine Auflistung von Triggern mithilfe der Trigger-Eigenschaft an. Diese Sammlung enthält eine oder mehrere einzelne Trigger-APIs, wobei jede API einen bestimmten Triggertyp angibt. In der Abbildung unten enthält die Triggerauflistung beispielsweise einen Starttrigger, einen Anmeldetrigger und einen täglichen Trigger.

Taskplaner 2.0-Triggerschnittstellen

Objekt-APIs für die Skriptentwicklung

Weitere Informationen zu den Methoden und Eigenschaften der Objekte, die zum Angeben von Triggern verwendet werden, finden Sie unter:

Schnittstellen-APIs für die C++-Entwicklung

Weitere Informationen zu den Methoden und Eigenschaften der Schnittstellen, die zum Angeben von Triggern verwendet werden, finden Sie unter:

Taskplaner 1.0-Triggerschnittstellen

Vorhandene Anwendungen, die mit Taskplaner 1.0 entwickelt werden, können die Methoden verwenden, die über die Taskplaner 1.0-Schnittstellen verfügbar sind, um die Trigger für ein Arbeitselementzu erstellen, abzurufen, zu ändern und zu löschen. Beachten Sie jedoch, dass alle Taskplaner 1.0-Schnittstellen, -Enumerationen und -Strukturen veraltet sind und nicht für die Entwicklung neuer Anwendungen verwendet werden sollten.

Die beiden Schnittstellen, die dazu verwendet werden, sind in der folgenden Abbildung dargestellt. Die IScheduledWorkItem-Schnittstelle wird verwendet, um alle Trigger zu verwalten, die einem Arbeitselement zugeordnet sind (eine solche Verwaltung umfasst das Erstellen eines neuen Triggers für das Arbeitselement). Die ITaskTrigger-Schnittstelle wird zum Verwalten eines bestimmten Triggers verwendet.

Taskplaner 1.0-Triggerschnittstellen

Die IScheduledWorkItem-Schnittstelle stellt Methoden zum Erstellen eines neuen Triggers für ein Arbeitselement, zum Abrufen der Anzahl von Triggern, die einem Arbeitselement zugeordnet sind, zum Abrufen der Triggerstrukturen, die dem Arbeitselement zugeordnet sind, zum Abrufen von Triggerzeichenfolgen, die dem Arbeitselement zugeordnet sind, und zum Löschen von Triggern bereit.

Sobald das Triggerobjekt verfügbar ist, können Sie die ITaskTrigger-Schnittstelle verwenden, um die Triggerstruktur und die Zeichenfolge des Triggers abzurufen und die Kriterien festzulegen, die zum Auslösen des Triggers verwendet werden. Diese Schnittstelle wird nur verwendet, wenn Sie mit einem Aufgabentriggerobjektarbeiten.

Aufgabentrigger

Triggertypen

Triggerstrukturen