help_callback_init_c

	status.i4.v = help_callback_init_c(select_arg.g.v, select_type.i4.v,
					   row.i4.v, column.i4.v, height.i4.v,
					   width.i4.v, help_arg_1.g.v,
					   help_arg_2.g.v, help_type.i4.v,
					   help_id.i4.r, display_row.i4.v,
					   display_column.i4.v, coord_type.i4.v
					   [,handle.i1a.r])

	This routine will create a help callback for a window.  All help
	fields in a window are automatically deleted when the window is
	deleted.

	select_arg	window selection value which depends on "select_type"
	select_type	type of window selection value
			(WMNGR_BY_WINDOW_ID -> window ID (use WMNGR_BACKGROUND
					       for the background window or
					       WMNGR_NEXT_WINDOW_CREATED for
					       the next window to be created),
			 WMNGR_BY_WINDOW_HANDLE -> null terminated window
						   handle)
	row		top row of the help region
			Special values are:
			(WMNGR_CENTER -> center the help region top to bottom,
			 WMNGR_ENTIRE_WINDOW -> help region will cover the
					       entire window)
	column		left column of the help region
			(WMNGR_CENTER -> center the help region left to right
					 in the window,
			 WMNGR_ENTIRE_LINE -> help region will fill the
					      entire line)
	height		height of help region in rows
	width		width of help region in columns
	help_arg_1	help specification value whose interpretation depends
			on the value of "help_type"
			(WMNGR_BY_FILE_NAME -> "help_arg_1" specifies a null
					       terminated compressed help
					       text file name or a simple
					       ASCII text file name,
			 WMNGR_BY_FUNCTION -> "help_arg_1" specifies a function
					      to be called,
			 WMNGR_BY_CONSOLE_HELP -> "help_arg_1" specifies the
						  desired help level (1-3),
			 WMNGR_BY_TEXT_STRING -> "help_arg_1" specifies
						 a simple help text string,
			 WMNGR_BY_URL -> "help_arg_1" specifies a null
					 terminated WWW URL string)
			(Note: The preferred extension for ASCII file names
			 is ".cshlp".  If no path is specified for a file
			 with this extension, it is assumed to be in the
			 MECCA directory of the calling program.)
	help_arg_2	help specification value whose interpretation depends
			on the value of "help_type"
			(WMNGR_BY_FILE_NAME -> "help_arg_2" specifies a record
					       number (If this argument has a
					       value of zero or is defaulted
					       by passing a null pointer,
					       "help_arg_1" is a simple ASCII
					       text file.),
			 WMNGR_BY_FUNCTION -> "help_arg_2" specifies a data
					      pointer to be passed to function
					      "help_arg_1",
			 WMNGR_BY_CONSOLE_HELP -> "help_arg_2" specifies the
						  desired help entry
						  (1-30 for level 2 and
						   1-600 for level 3),
			 WMNGR_BY_TEXT_STRING -> "help_arg_2" specifies the
						 length of the help text string
						 (If this argument has a value
						  of zero or a null pointer is
						  passed, the help string will
						  be assumed to be null
						  terminated.),
			 WMNGR_BY_URL -> "help_arg_2" is ignored)
	help_type	type of help specification values
			(WMNGR_BY_FILE_NAME -> "help_arg_1" specifies a null
					       terminated compressed help
					       text file name and "help_arg_2"
					       specifies a record number,
			 WMNGR_BY_FUNCTION -> "help_arg_1" specifies a function
					      to be called and "help_arg_2"
					      specifies a data pointer to
					      be passed to that function
			(function called as follows:
			 help_func(wid.i2.v, func_data.g.v, help_data.s.r,
				   text_data.s.r)
			 ("help_data" is a structure of type
			  HELP_FUNCTION_DATA (row and column fields are in
			  physical coordinates), "text_data" is the returned
			  text and is a structure of type TEXT_BLOCK_DATA))
			 WMNGR_BY_CONSOLE_HELP -> "help_arg_1" specifies a
						  console help level and
						  "help_arg_2" specifies a
						  help entry on that level,
			 WMNGR_BY_TEXT_STRING -> "help_arg_1" specifies
						 a simple help text string and
						 "help_arg_2" specifies its
						 length  (Note: Line feed
						 characters can be embedded
						 in the text to format a
						 multiple line message.),
			 WMNGR_BY_URL -> "help_arg_1" specifies a null
					 terminated WWW URL string
					 (Display positioning arguments are
					 ignored since the help will be
					 displayed on a Web browser.)
	help_id		returned help region ID
			(can be passed to help_callback_term_c)
			(Note: If this argument is not needed, a value of
			 NULL can be passed for it.)
	display_row	top row of help display window
			(use WMNGR_CENTER for centering)
	display_column	left column of help display window
			(use WMNGR_CENTER for centering)
	coord_type	reference for display coordinates
			(WMNGR_ABSOLUTE_COORDS -> full screen coordinates,
			 WMNGR_WINDOW_COORDS -> window coordinates,
			 WMNGR_INTERRUPT_COORDS -> coordinates relative to
						   the location of the help
						   interrupt,
			 WMNGR_AUTO_COORDS -> help window will be placed
					      adjacent to the help field
					      ("display_row" and
					       "display_column" will be ignored)
	[handle]	null terminated ASCII handle to be used as an
			alternate means of identifying this help field
			(Note: If this argument is not needed, a value of
			 NULL can be passed for it.) (default is NULL)

	This function returns ACNET status values as follows:

	OK			success
	CBS_INVARG		invalid select type, help type, width, or height
	CBS_NO_WINDOW		window doesn't exist
	CBS_INVSIZ		help region is too big to fit in the window
	CBS_NOT_IN_WINDOW	help region is not entirely in the
				requested window
	CBS_MEMFAIL		failed in allocating dynamic memory

	This function requires the following include files:

	cnsparam_h, cns_data_structs_h, cbslib_h, acnet_errors_h

	Related functions:

	help_callback_term_c, help_window_delete_c, help_enable_disable_c,
	window_has_help_c

	C/C++ usage:

	static const char	help_file[] = "help_file.cshlp";
	static const char	handle[] = "my_help_field";
	short	window_id = WMNGR_BACKGROUND;
	int	status;
	int	select_type = WMNGR_BY_WINDOW_ID;
	int	row = 5;
	int	column = 1;
	int	height = 1;
	int	width = 10;
	int	help_type = WMNGR_BY_FILE_NAME;
	int	help_id;
	int	display_row = 0;
	int	display_column = 0;
	int	coord_type = WMNGR_AUTO_COORDS;
	void	*help_arg_2 = (void *) NULL;

	status = help_callback_init_c((void *) &window_id,select_type,
				      row,column,height,width,
				      (void *)  help_file,help_arg_2,
				      help_type,&help_id,display_row,
				      display_column,coord_type,handle);