Application.OnTime, méthode (Excel)

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)

expression Une variable qui représente un objet Application.

Paramètres

Nom Requis/Facultatif Type de données Description
EarliestTime Requis Variant Heure à laquelle vous voulez que la procédure s'exécute.
Procedure Requis String 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éfinie sur EarliestTime + 30 et que Microsoft Excel n’est pas en mode Prêt, Copier, Couper ou Rechercher au plus tôt, car une autre procédure est en cours d’exécution, Excel attendra 30 secondes avant la fin de la première procédure. Si Excel n’est pas en mode Prêt dans un délai de 30 secondes, la procédure ne sera pas exécuté. Si cet argument est omis, Excel attendez que la procédure puisse être exécuté.
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 une utilisation à exécuter lorsqu’un laps de temps spécifique (à partir de maintenant) s’est écoulé. 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 Procedure 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 exécute myProcedure_ dans 15 secondes.

Application.OnTime Now + TimeValue("00:00:15"), "my_Procedure"

Cet exemple exécute myProcedure_ à 17h00.

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.