_Application.OnTime(Object, String, Object) Méthode

Définition

Démarre une horloge d'arrière-plan qui exécute une macro à l'heure spécifiée.

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)

Paramètres

When
Object

Objetrequired. Heure à laquelle la macro doit être exécutée. Peut être une chaîne qui spécifie une heure (par exemple, « 4:30 PM » ou « 16:30 »), ou il peut s’agir d’un numéro de série renvoyé par une fonction telle que TimeValue ou TimeSerial (par exemple, TimeValue ("2:30 PM") ou TimeSerial (14, 30, 00)). Vous pouvez également inclure la date (par exemple, « 6/30 4:15 PM » ou TimeValue ("6/30 4:15 PM")). Utilisez la somme des valeurs renvoyées de la fonction Now et de la fonction TimeValue ou TimeSerial pour définir une horloge afin d’exécuter une macro un certain temps après l’exécution de l’instruction. Par exemple, utilisez Now+TimeValue("00:05:30") pour exécuter une macro 5 minutes et 30 secondes après l'exécution de l'instruction.

Name
String

Argument de type String obligatoire. Nom de la macro à exécuter. Utilisez le chemin d’accès complet à la macro pour vous assurer que la macro correcte est exécutée (par exemple, « Project. Module1. Macro1 »). Pour que la macro s’exécute, le document ou le modèle doit être disponible lorsque l’instruction OnTime est exécutée et lorsque l’heure spécifiée par l’instruction When arrive. Pour cette raison, il est préférable de stocker la macro dans normal. dot ou un autre modèle global qui est chargé automatiquement.

Tolerance
Object

Objetfacultatif. Durée maximale (en secondes) pouvant s’écouler avant l’annulation d’une macro qui n’a pas été exécutée au moment indiqué par When . Les macros ne sont pas toujours exécutées au moment spécifié. Par exemple, si une opération de tri est en cours ou si une boîte de dialogue est affichée, la macro sera retardée jusqu'à ce que Word ait achevé la tâche active. Si cet argument a la valeur 0 (zéro) ou est omis, la macro est exécutée, quel que soit le temps écoulé depuis le moment spécifié par When .

Remarques

Microsoft Word ne peut gérer qu’une seule horloge d’arrière-plan définie par OnTime. Si vous démarrez une autre avant exécution du compteur existant, le minuteur existant est annulé.

S’applique à