Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cette méthode programme l'exécution d'une procédure à un moment précis (soit à une heure précise soit après l'écoulement d'un délai précis).
Syntaxe
expression. OnTime (EarliestTime, Procedure, LatestTime, Schedule)
expressionUne variable qui représente un objetApplication.
Paramètres
| Nom | Requis/Facultatif | Type de données | Description |
|---|---|---|---|
| EarliestTime | Obligatoire | Variante | Heure à laquelle vous voulez que la procédure s'exécute. |
| Procedure | Obligatoire | Chaîne | Nom de la procédure à exécuter. |
| LatestTime | Facultatif | Variant | Toute dernière heure à laquelle la procédure peut être exécutée. Par exemple, si LatestTime est défini sur EarliestTime + 30 et que Microsoft Excel n’est pas en mode Prêt, Copier, Couper ou Rechercher à EarliestTime car une autre procédure est en cours d’exécution, Excel attend 30 secondes que la première procédure se termine. Si Excel n’est pas en mode Prêt dans les 30 secondes, la procédure ne sera pas exécutée. Si cet argument est omis, Excel attend que la procédure puisse être exécutée. |
| Schedule | Facultatif | Variant | Cet argument a la valeur True pour programmer une nouvelle procédure OnTime. Il a la valeur False pour effacer une procédure précédemment définie. La valeur par défaut est True. |
Remarques
Permet Now + TimeValue(time) de planifier l’exécution d’une opération lorsqu’une durée spécifique (à compter de maintenant) s’est écoulée. Utilisez TimeValue(time) pour programmer une procédure à exécuter à un moment précis.
La valeur de EarliestTime est arrondie à la seconde la plus proche.
Définissez Schedule sur False pour effacer une procédure précédemment définie avec les mêmes valeurs Procédure et EarliestTime .
Procedure ne doit prendre aucun argument et ne peut pas être déclarée dans une classe ou un formulaire personnalisé.
Exemple
Cet exemple est exécuté my_Procedure 15 secondes à partir de maintenant.
Application.OnTime Now + TimeValue("00:00:15"), "my_Procedure"
Cet exemple s’exécute my_Procedure à 17 heures.
Application.OnTime TimeValue("17:00:00"), "my_Procedure"
Cet exemple montre comment annuler le paramétrage de OnTime de l'exemple précédent.
Application.OnTime EarliestTime:=TimeValue("17:00:00"), _
Procedure:="my_Procedure", Schedule:=False
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.