


DXmHelpSystemDisplay(3X)			     DXmHelpSystemDisplay(3X)



NAME
  DDXXmmHHeellppSSyysstteemmDDiissppllaayy - Displays a topic or directory of the help file	in
  Bookreader.

SYNOPSIS

  vvooiidd DDXXmmHHeellppSSyysstteemmDDiissppllaayy((_h_e_l_p__c_o_n_t_e_x_t,, _h_e_l_p__f_i_l_e,, _k_e_y_w_o_r_d,, _n_a_m_e,, _r_o_u_t_i_n_e,,
  _t_a_g))
	OOppaaqquuee	_h_e_l_p__c_o_n_t_e_x_t;;
	cchhaarr	**_h_e_l_p__f_i_l_e;;
	cchhaarr	**_k_e_y_w_o_r_d;;
	cchhaarr	**_n_a_m_e;;
	vvooiidd	((((**_r_o_u_t_i_n_e ))(()))),,
	OOppaaqquuee	_t_a_g ));;

PARAMETERS

  _h_e_l_p__c_o_n_t_e_x_t
      Used by the DECwindows Motif Help	System to pass required	LinkWorks and
      help information from one	routine	to another.

  _h_e_l_p__f_i_l_e
      Optional.	 The file name of the help file. If Null or "" is supplied,
      Bookreader will use the help file	name passed in to the DDXXmmHHeellppSSyysstteemmOO--
      ppeenn routine; otherwise a new file	name can be passed.

  _k_e_y_w_o_r_d
      One of two values: "topic" or "dir".  Pointers to	these strings can be
      passed instead.

  _n_a_m_e
      The topic	symbol from the	help callback if "topic" is used for the key-
      word.  If	"dir" is used, then _n_a_m_e 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.

  _r_o_u_t_i_n_e
      Used for error processing.  If an	error occurs within the	DECwindows
      Motif Help System	and it cannot be processed by either LinkWorks or
      Bookreader, the DECwindows Motif Help System calls the error processing
      routine you have included	in your	application and	passes in an integer,
      or _s_t_a_t_u_s, 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:

	oo++
	The _s_t_a_t_u_s parameter is	a _s_y_s_t_e_m-_s_u_p_p_l_i_e_d parameter that supplements
	the _r_o_u_t_i_n_e and	_t_a_g parameters you have	already	specified in the
	application.

	oo++
	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.

  _t_a_g The parameter you	supply to the previously described _r_o_u_t_i_n_e parameter.
      Associating a tag	with the routine enables you to	more easily determine
      where errors occur.

DESCRIPTION

				     NNOOTTEE

       This routine is not supported on	all operating systems.

  The DDXXmmHHeellppSSyysstteemmDDiissppllaayy 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
  DDXXmmHHeellppSSyysstteemmOOppeenn.

RELATED	INFORMATION

  DDXXmmHHeellppSSyysstteemmDDiissppllaayy(3X), DDXXmmHHeellppSSyysstteemmOOppeenn(3X)




























