Microsoft KB Archive/141537

= ACC: How to Create a Function That Pauses Program Execution =

Article ID: 141537

Article Last Modified on 1/19/2007

-

APPLIES TO


 * Microsoft Access 1.0 Standard Edition
 * Microsoft Access 1.1 Standard Edition
 * Microsoft Access 2.0 Standard Edition
 * Microsoft Access 95 Standard Edition
 * Microsoft Access 97 Standard Edition

-



This article was previously published under Q141537



Moderate: Requires basic macro, coding, and interoperability skills.



SUMMARY
This article shows you how to create a sample user-defined function called Wait that you can use to delay program execution for a specified period of time. You can call this function from any form or report event procedure or from a RunCode macro action.

This article assumes that you are familiar with Visual Basic for Applications and with creating Microsoft Access applications using the programming tools provided with Microsoft Access. For more information about Visual Basic for Applications, please refer to your version of the "Building Applications with Microsoft Access" manual.

NOTE: Visual Basic for Applications is called Access Basic in Microsoft Access versions 1.x and 2.0. For more information about Access Basic, please refer to the "Introduction to Programming" manual in Microsoft Access version 1.x or the "Building Applications" manual in Microsoft Access version 2.0



MORE INFORMATION
To create the sample user-defined Wait function, open a new module and enter the following code: '**********************************************************  ' Declarations section of the module '**********************************************************

Option Explicit

'===================================================================  ' NOTE: In Visual or Access Basic the unit of greatest precision ' is seconds. Therefore if the Timer is set to wait one second, the ' result could be a delay of anywhere from 0 to 1 second. If a higher ' degree of precision is required, another option is to use the Timer ' event of the form which has the ability to trigger every 1000th of a  ' second. '====================================================================

Function Wait (Delay As Integer, DispHrglass As Integer)

Dim DelayEnd As Double DoCmd.Hourglass DispHrglass '(In Microsoft Access 2.0 and 1.x use: DoCmd Hourglass DispHrglass) DelayEnd = DateAdd("s", Delay, Now) While DateDiff("s", Now, DelayEnd) > 0 Wend DoCmd.Hourglass False '(In Microsoft Access 2.0 and 1.x use: DoCmd Hourglass False) End Function

