| << SL_DrawIconAsTemplate | SL_EndTimerRequest >> |
| Top: Documentation Library | Up: SoftLogik App Library API |
SL_StartNewTimerRequest
NAME
SL_StartNewTimerRequest -- Allocates, inits, and starts a new timer request.
SYNOPSIS
timehandle = SL_StartNewTimerRequest(apphandle, date, time, flags, userdata);
D0 A0 D0 D1 D2 D3
TIMEHANDLE SL_StartNewTimerRequest(APPHANDLE, ULONG, ULONG, ULONG, SLTAGDATA);
FUNCTION
When a timehandle elapses an AppMsg is sent to the application's app
callback. The message type is APPMSG_TIMER. The data is the userdata
as passed to this function. The timehandle is freed and ended when
this message is generated so there is no need to call SL_EndTimerRequest
on it.If the timehandle is repeating, the time request is automatically
reposted when it elapses. These types of requests must be ended.
INPUTS
apphandle - as returned by SL_AppInitA.
date - the date of the request (in the format YYYYMMDD - see SL_GetDate).
time - the time of the request (in the format HHMMSSII - see SL_GetTime).
flags - any of the TIMERFLG_xxx flags.
TIMEFLG_RELATIVE - the date and time are relative to the
current time.
TIMEFLG_REPEAT - the request will be repeated (only valid
for TIMEFLG_RELATIVE).
userdata - any SLTAGDATA value the user wants. This will be sent back to
the app in the AppMsg->data field when this request elapses.
SEE ALSO
SL_EndTimerRequest, SL_GetTime, SL_GetDate, Callback-Application.
SL_StartNewTimerRequest Command Section By Type url:SL_StartNewTimerRequest
created:2008-03-01 23:36:35 last updated:2008-03-01 23:36:35
Copyright © 1985-2024 GrasshopperLLC. All Rights Reserved.
| User Contributed Comments For SL_StartNewTimerRequest | sign in to add a comment |
| There are no user contributed comments for this page. | |
| << SL_DrawIconAsTemplate | SL_EndTimerRequest >> |
| Top: Documentation Library | Up: SoftLogik App Library API |