Application.OnTime-Methode (Word)

  • Artikel

Startet einen Hintergrundtimer, der ein Makro zu einer angegebenen Uhrzeit ausführt.

Syntax

Ausdruck. OnTime( _When_ , _Name_ , _Tolerance_ )

Ausdruck: Erforderlich. Eine Variable, die ein Application -Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
Wann Erforderlich Variant Die Zeit, zu der das Makro ausgeführt werden soll.
Name Erforderlich String Der Name des auszuführenden Makros.
Toleranz Optional Variant Der maximale Zeitraum (in Sekunden), nach dem ein Makro abgebrochen wird, das zu dem mit When festgelegten Zeitpunkt nicht ausgeführt wurde. Makros können nicht immer zum angegebenen Zeitpunkt ausgeführt werden. Wenn z. B. noch eine Sortierung ausgeführt oder ein Dialogfeld angezeigt wird, verzögert sich die Ausführung des Makros, bis der Vorgang in Word abgeschlossen ist. Wenn dieses Argument 0 (null) ist oder weggelassen wird, wird das Makro unabhängig davon ausgeführt, wie viel Zeit seit dem durch When festgelegten Zeitpunkt vergangen ist.

HinwBemerkungeneise

Der When-Parameter kann eine Zeichenfolge sein, die eine Zeit angibt (z. B. oder "16:30"), oder es kann sich um eine fortlaufende Zahl handeln, "4:30 pm"TimeValue("2:30 pm") die von einer Funktion wie TimeValue oder TimeSerial zurückgegeben wird (z. B. oder TimeSerial(14, 30, 00)). Sie können auch das Datum einschließen (z. B "6/30 4:15 pm" . oder TimeValue("6/30 4:15 pm")).

Verwenden Sie für den Parameter Name den vollständigen Makropfad, um sicherzustellen, dass das richtige Makro ausgeführt wird (z. B "Project.Module1.Macro1". ). Damit das Makro ausgeführt werden kann, muss das Dokument oder die Vorlage sowohl verfügbar sein, wenn die OnTime-Anweisung ausgeführt wird, als auch wenn die durch Eintreffen angegebene Zeit angegeben wird. Aus diesem Grund empfiehlt es sich, das Makro in Normal.dot oder einer anderen globalen Vorlage zu speichern, die automatisch geladen wird.

Verwenden Sie die Summe der Rückgabewerte der Now-Funktion und die Funktion TimeValue oder TimeSerial, um einen Timer so einzustellen, dass ein Makro in einem bestimmten Zeitabstand nach dem Ausführen der Anweisung gestartet wird. Verwenden Sie Now+TimeValue("00:05:30") beispielsweise , um ein Makro 5 Minuten und 30 Sekunden nach ausführung der Anweisung auszuführen.

In Word kann jeweils nur ein mit OnTime festgelegter Hintergrundtimer eingesetzt werden. Wenn Sie einen weiteren Timer starten, bevor ein vorhandener Timer ausgeführt werden konnte, wird der vorhandene Timer abgebrochen.

Beispiel

In diesem Beispiel wird das Makro Macro1 im aktuellen Modul um 15:55 Uhr ausgeführt.

Application.OnTime When:="15:55:00", Name:="Macro1"

In diesem Beispiel wird das Makro Macro1 15 Sekunden nach dem Ausführen des Beispiels ausgeführt. Der Makroname enthält den Namen des Projekts und des Moduls.

Application.OnTime When:=Now + TimeValue("00:00:15"), _ 
 Name:="Project1.Module1.Macro1"

In diesem Beispiel wird das Makro Start um 13:30 Uhr ausgeführt. Der Makroname enthält den Namen des Projekts und des Moduls.

Application.OnTime When:=TimeValue("1:30 pm"), _ 
 Name:="VBAProj.Module1.Start"

Siehe auch

Application-Objekt

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.