_Application.OnTime(Object, String, Object) Methode

Definition

Namespace:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

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

public void OnTime (ref object When, string Name, ref object Tolerance);

abstract member OnTime : obj * string * obj -> unit

Public Sub OnTime (ByRef When As Object, Name As String, Optional ByRef Tolerance As Object)

Parameter

When

Object

Erforderliches Objekt. Die Zeit, zu der das Makro ausgeführt werden soll. Kann eine Zeichenfolge sein, die eine Uhrzeit angibt (z. B. "16:30 Uhr" oder "16:30"), oder es kann sich um eine fortlaufende Zahl handeln, die von einer Funktion wie TimeValue oder TimeSerial zurückgegeben wird (z. B. TimeValue("14:30 pm") oder TimeSerial(14, 30, 00)). Sie können auch das Datum einschließen (z. B. "30.06.15 Uhr" oder TimeValue("6/30 16:15 Pm")). Verwenden Sie die Summe der Rückgabewerte der Now-Funktion und entweder der TimeValue- oder timeSerial-Funktion , um einen Timer festzulegen, der ein Makro für einen bestimmten Zeitraum nach der Ausführung der Anweisung ausführen soll. Verwenden Sie z. B. Now+TimeValue("00:05:30"), wenn ein Makro 5 Minuten und 30 Sekunden nach dem Ausführen der Anweisung gestartet werden soll.

Name

String

String erforderlich. Der Name des auszuführenden Makros. Verwenden Sie 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 When angegebene Zeit eintrifft. Aus diesem Grund empfiehlt es sich, das Makro in Normal.dot oder einer anderen globalen Vorlage zu speichern, die automatisch geladen wird.

Tolerance

Object

Optionales Objekt. Die maximale Zeit (in Sekunden), die verstreichen kann, bevor ein Makro, das zu dem von When angegebenen Zeitpunkt nicht ausgeführt wurde, abgebrochen wird. 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 ausgelassen wird, wird das Makro unabhängig davon ausgeführt, wie viel Zeit seit der durch Whenangegebenen Zeit verstrichen ist.

Hinweise

Microsoft Word kann nur einen Hintergrundtimer verwalten, der von OnTime festgelegt wird. Wenn Sie einen weiteren Timer starten, bevor ein vorhandener Timer ausgeführt werden konnte, wird der vorhandene Timer abgebrochen.