Contents | Index | < Browse | Browse >
SETPOINTER GuiFile #Image/DEFAULT/HIDE
Will allow you to change the pointer which will be used whenever
the given gui's window is active.
The pointers you can set are:
* #Image
This will take an image (which you must have loaded previously
with the LoadImage command) and make it the window's current
pointer. You must precede the image name (ie its alias) with a
'#' character : <SetPointer mygui.gc #MyImage>
Pointers have restrictions. They must be drawn using only the
first 4 colors of the screen's palette, and must be a maximum
of 16 pixels wide. Otherwise it will look lousy..
* DEFAULT
Set the user's default preferences pointer.
* HIDE
Hide the current pointer. Note that when when hidden, the pointer
is still ative, ie you can click with it - you just can't see where
it is.. If you want to block user input, use < GuiWindow gui Wait>
!!! IMPORTANT !!!
If you have set a custom pointer and then free the image while
the pointer is active you'll get a crash like you wouldn't
believe. To avoid this, Gui4Cli will warn you with an ERROR
message and abort.
The correct way to quit a gui which has a custom pointer is :
xOnClose
SetPointer #this default ; use the default pointer
FreeImage MyPointerImage ; now you can free the pointer
GuiQuit #this ; quit now if you want..