_Application.OnTime(Object, String, Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicia um cronômetro em segundo plano que executa uma macro em uma hora especificada.
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)Parâmetros
- When
- Object
Objetonecessário. A hora em que a macro será executada. Pode ser uma cadeia de caracteres que especifica uma hora (por exemplo, "4:30 PM" ou "16:30") ou pode ser um número de série retornado por uma função como TimeValue ou TimeSerial (por exemplo, TimeValue ("2:30 p.m.") ou TimeSerial (14, 30, 00)). Você também pode incluir a data (por exemplo, "6/30 4:15 PM" ou TimeValue ("6/30 4:15 PM")). Use a soma dos valores de retorno da função Now e a função TimeValue ou TimeSerial para definir um timer para executar uma macro por um período especificado após a execução da instrução. Por exemplo, use Now+TimeValue("00:05:30") para executar uma macro 5 minutos e 30 segundos após a instrução ser executada.
- Name
- String
String necessário. O nome da macro a ser executada. Use o caminho de macro completo para garantir que a macro correta seja executada (por exemplo, "Project. Module1. Macro1"). Para que a macro seja executada, o documento ou modelo deve estar disponível quando a instrução ontime for executada e quando o tempo especificado por When chegar. Por esse motivo, é melhor armazenar a macro no normal. dot ou em outro modelo global carregado automaticamente.
- Tolerance
- Object
Objetoopcional. O tempo máximo (em segundos) que pode decorrer antes que uma macro que não foi executada no momento especificado por When seja cancelada. As macros podem não ser sempre executadas na hora especificada. Por exemplo, se uma operação de classificação estiver em andamento ou uma caixa de diálogo estiver sendo exibida, a macro se atrasará até que o Word tenha completado a tarefa. Se esse argumento for 0 (zero) ou omitido, a macro será executada independentemente de quanto tempo decorrido desde o tempo especificado por When .
Comentários
O Microsoft Word pode manter apenas um cronômetro de plano de fundo definido por ontime. Se você iniciar outro cronômetro antes de esgotar um cronômetro existente, o cronômetro existente será cancelado.