Share via

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

  • Référence

Définition

Espace de noms:
Microsoft.Office.Interop.Word
Assembly:
Microsoft.Office.Interop.Word.dll

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

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é.

S’applique à