| C T L _ F I N D S C R E E N S A F E ( )
| | | | | SOURCE: qdev_autodocs.txt 1.163 (12/09/2014) English AMIGA - CTL_#?
----------------------------------------------------------------------------
NAME
ctl_findscreensafe() - Try to find the screen in the
OS without probing(opening) it.
SYNOPSIS
res = ctl_findscreensafe(pubname, buf, len);
LONG ctl_findscreensafe(UBYTE *, UBYTE *, LONG);
FUNCTION
This function is similar to 'ctl_lockscreensafe()' in
that it will not trigger screen opening. All it does
is to find the screen and copy its name to the buffer
provided.
INPUTS
pubname - Pub. screen name(not a title!). NULL for
'Workbench'. Use '*' to obtain a name of
current/active screen. Case sensitive!
buf - Buffer to store the screen name. This can
be NULL if just an indication is needed.
len - Buffer size. If 0 then plain indication.
RETURNS
Returns negative value if buffer is too small to hold
the entire name, -1 if no buffer was provided, 0 if
screen was not found and 1 for success.
BASES
IntuitionBase
NOTES
None.
SEE ALSO
ctl_lockscreensafe(), ctl_unlockscreensafe()
EXAMPLE
None.
BUGS
None known.
----------------------------------------------------------------------------
| |
| |