dxmhelpsystemdisplay(3x) [osf1 man page]

DXmHelpSystemDisplay(3X)												  DXmHelpSystemDisplay(3X)

NAME

       DXmHelpSystemDisplay - Displays a topic or directory of the help file in Bookreader.

SYNOPSIS

       void DXmHelpSystemDisplay(
	       Opaque help_context,
	       char *help_file,
	       char *keyword,
	       char *name,
	       void ((*routine )()),
	       Opaque tag );

PARAMETERS

       Used  by the DECwindows Motif Help System to pass required LinkWorks and help information from one routine to another.  Optional.  The file
       name of the help file. If Null or is supplied, Bookreader will use the help file name passed in to the DXmHelpSystemOpen routine; otherwise
       a  new  file  name can be passed.  One of two values: "topic" or "dir".	Pointers to these strings can be passed instead.  The topic symbol
       from the help callback if "topic" is used for the keyword. If "dir" is used, then name refers to the name of the Bookreader directory  that
       should  be opened, such as "Contents" or "Index". Either specific strings or pointers to strings may be passed in.  Used for error process-
       ing.  If an error occurs within the DECwindows Motif Help System and it cannot be processed by either LinkWorks or Bookreader, the  DECwin-
       dows  Motif  Help  System  calls the error processing routine you have included in your application and passes in an integer, or status, to
       indicate the status of the error processing operation, as follows:

	      --------------------------------------------------------------------
	      Value   Description
	      --------------------------------------------------------------------
	      1       The  DECwindows  Motif  Help  System  could  not	find  the
		      LinkWorks shareable image.
	      2       The  DECwindows  Motif  Help  System  could not translate a
		      specified value into a valid file specification.
	      --------------------------------------------------------------------

	      Note the following: The status parameter is a system-supplied parameter that supplements the routine and	tag  parameters  you  have
	      already  specified in the application.  If an error cannot be processed by either LinkWorks or Bookreader and you have not specified
	      a supplementary error handling routine, your system will generate an access violation error message.  The parameter  you	supply	to
	      the  previously  described  routine parameter.  Associating a tag with the routine enables you to more easily determine where errors
	      occur.

DESCRIPTION

									  Note

       This routine is not supported on all operating systems.

       The DXmHelpSystemDisplay routine (which you use instead of a call to the help widget) displays a topic or directory of  the  help  file	in
       Bookreader, using the DECwindows Motif Help System.  This routine can also be used to display topics or directories of books other than the
       ones passed in to DXmHelpSystemOpen.

SEE ALSO

       DXmHelpSystemDisplay(3X), DXmHelpSystemOpen(3X)

															  DXmHelpSystemDisplay(3X)

Check Out this Related Man Page

XHPSetErrorHandler(3X)													    XHPSetErrorHandler(3X)

NAME

       XHPSetErrorHandler - Register an X error handling routine.

SYNOPSIS

       #include <X11/XHPlib.h>

       typedef int (*PFI) ();

       PFI XHPSetErrorHandler (display, routine)
	    Display   *display;
	    int  (*routine) ();

       int routine (display, error)
	    Display	   *display;
	    XErrorEvent    *error;

DESCRIPTION

       This request registers with Xlib the address of a routine to handle X errors.  It is intended to be used by libraries and drivers that wish
       to establish an error handling routine without interfering with any error handling routine that may have been established by the client
       program.

       XHPSetErrorHandler records one error handling routine per connection to the server.  Therefore, in order for a library or driver to set up
       its own error handling routine without affecting that of the client, the library or driver must first have established its own connection
       to the server via XOpenDisplay.

       When an XErrorEvent is received by the client, which error handling routine is invoked is determined by the display associated with the
       error.  If the display matches that associated with a driver error handling routine, that error handling routine will be invoked.  If it
       does not match any driver routine, the error handling routine established by the client, if any exists, will be invoked.  Otherwise, the
       default Xlib error handler will be invoked.

       XHPSetErrorHandler returns the address of the previously established error handler.  If that error handler was the default error handler,
       NULL is returned.

       A driver or library may remove its error handler by invoking XHPSetErrorHandler with a NULL error handling routine.

FILES

       /usr/include/X11/XHPlib.h

ORIGIN

       Hewlett-Packard Company

SEE ALSO

       XSetErrorHandler(3x)

X Version 11							     Release 5						    XHPSetErrorHandler(3X)

Linux and UNIX Man Pages

dxmhelpsystemdisplay(3x) [osf1 man page]

Check Out this Related Man Page