Important: The information in this document is obsolete and should not be used for new development.
GXSetUserGraphicsNoticeYou can use the
GXSetUserGraphicsNoticefunction to install a notice handler.
void GXSetUserGraphicsNotice(gxUserNoticeFunction userFunction, long reference);
- The application function that is to be passed the notice result code.
longvalue that is called each time a notice occurs. This value can be used by the application for any purpose.
GXSetUserGraphicsNoticefunction installs an application-defined notice- handling function. This function installs a function pointer that is called whenever a notice is posted. Setting the
nilremoves the notice function.
userFunctionparameter points to an application-defined notice handler defined by the following type:
typedef void (*gxUserNoticeProcPtr)(gxGraphicsNotice status, long reference) typedef gxUserNoticeProcPtr gxUserNoticeFunction;The second parameter is the
longreference. Whenever a notice is posted by the application, the installed notice handler is called with the notice number. The reference number is passed to the
You can install a notice handler before calling the
GXEnterGraphicsfunction, but you should call the
GXNewGraphicsClientfunction first. If you don't, it will be called for you.
GXSetUserGraphicsNoticefunction has no effect in the non-debugging version.
SEE ALSOThe use of this function is described in the section "Installing an Error, Warning, or Notice Handler" beginning on page 3-38.
GXGetUserGraphicsNoticefunction used to return a pointer to the application-defined notice handler is described in the next section.
The application-defined notice handler is described on page 3-72.