Help Object Library: 3.6 Customizing Help: Customizing the Pointer Image

Up: GEOS SDK TechDocs | Up | Prev: 3.5 Managing Help Files | Next: 3.7 Changing the Help Features
 ATTR_HELP_CUSTOM_POINTER_IMAGE,  MSG_HELP_CONTROL_GET_POINTER_IMAGE

The help controller changes the pointer image when the pointer is over a link in the help text. This is so the user knows where to click and expects a link to be followed. Applications that want custom pointers can set the "link" pointer image with ATTR_HELP_CUSTOM_POINTER_IMAGE . This attribute takes an optr to a custom pointer image definition.

The pointer image is a PointerDef structure and must be stored in a chunk in a sharable, non-duplicated data block. Note also that to use a custom pointer image, you must explicitly declare a HelpControl object, even for Normal Help.

You can retrieve the link pointer image by sending MSG_HELP_CONTROL_GET_POINTER_IMAGE to the HelpControl object. This will return the current image in use, either a custom image or the default. This message is detailed on MSG_HELP_CONTROL_GET_POINTER_IMAGE .


Up: GEOS SDK TechDocs | Up | Prev: 3.5 Managing Help Files | Next: 3.7 Changing the Help Features