Application.OnTime-Methode (Word)
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
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.
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für