_Application.OnTime(Object, String, Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitPublic Sub OnTime (ByRef When As Object, Name As String, Optional ByRef Tolerance As Object)Paramètres
- When
- Object
Objet obligatoire. Heure à laquelle la macro doit être exécutée. Il peut s’agir d’une chaîne qui spécifie une heure (par exemple, « 16 :30 pm » ou « 16 :30 »), ou d’un numéro de série retourné par une fonction telle que TimeValue ou TimeSerial (par exemple, TimeValue(« 14 :30 pm ») ou TimeSerial(14, 30, 00)). Vous pouvez également inclure la date (par exemple, « 6/30 16 :15 PM » ou TimeValue(« 6/30 16 :15 PM »)). Utilisez la somme des valeurs de retour de la fonction Now et de la fonction TimeValue ou TimeSerial pour définir un minuteur pour exécuter une macro une durée spécifiée 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 de 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 à la fois lorsque l’instruction OnTime est exécutée et lorsque l’heure spécifiée par When arrive. Pour cette raison, il est préférable de stocker la macro dans Normal.dot ou un autre modèle global chargé automatiquement.
- Tolerance
- Object
Objet facultatif. Durée maximale (en secondes) qui peut s’écouler avant qu’une macro qui n’a pas été exécutée à l’heure spécifiée par When soit annulée. 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 temps spécifié par When.
Remarques
Microsoft Word ne peut gérer qu’un minuteur d’arrière-plan défini par OnTime. Si vous démarrez une autre avant exécution du compteur existant, le minuteur existant est annulé.