| << SL_ScreenRequester | SL_GetFileSize >> |
| Top: Documentation Library | Up: SoftLogik App Library API |
SL_AlertRequesterA
NAME
SL_AlertRequesterA -- brings up a quick yes-no kindof requester.
SL_AlertRequester -- vargs stub.
SYNOPSIS
response = SL_AlertRequesterA(apphandle, type, msg, buttons, data);
D0 A0 D0 A1 A2 A3
UWORD SL_AlertRequesterA(APPHANDLE, UWORD, SLCHAR *, SLCHAR *, SLTAGTYPE *);
response = SL_AlertRequester(apphandle, type, msg, buttons, ...);
UWORD SL_AlertRequester(APPHANDLE, UWORD, SLCHAR *, SLCHAR *, ...)
FUNCTION
INPUTS
apphandle - as returned by SL_AppInitA.
type - one of:
ALERTTYPE_NOTE -
ALERTTYPE_WARN -
ALERTTYPE_ERROR -
msg - the text to be displayed in the "body" of the requester. This
string is a "C printf" style string and may contain any
"C printf" formating codes except for the floating point
codes (%f). Multiple lines may be displayed by using a
newline SLCHARacter (\\n) to separate them.
buttons - the buttons to be used in the requester for the exiting
of the requester. There can be any number of buttons in the
string each separated by a vertical bar '|' SLCHARacter. Each
button name can begin with a '^' to indicate that it should
be the default button or a '~' to indicate that it should be
the escape button.
data - a variable arg list used to process the msg string in a
"C printf" manner.
RESULTS
response - 0 if the requester was canceled. The requester is canceled
by pressing the rightmost button as specified in the button
string. Otherwise it will be a number 1-n that corresponds to
the remaining buttons in the string in left-right order. So a
1 would be returned if the leftmost button in the button string
was pressed.
NOTES
This functions puts the calling app into a wait state via SL_AppWaitState.
SEE ALSO
SL_AlertRequesterA, SL_BusyRequesterA, SL_FileRequester
, SL_FontRequester, SL_ScreenRequester.
SL_AlertRequesterA Command Section By Type url:SL_AlertRequesterA
created:2008-03-01 23:36:16 last updated:2008-03-01 23:36:16
Copyright © 1985-2024 GrasshopperLLC. All Rights Reserved.
| User Contributed Comments For SL_AlertRequesterA | sign in to add a comment |
| There are no user contributed comments for this page. | |
| << SL_ScreenRequester | SL_GetFileSize >> |
| Top: Documentation Library | Up: SoftLogik App Library API |