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..