wn_file_view_select_c

	status.i4.v = wn_file_view_select_c(x.r8.v, y.r8.v,
					    coordinate_type.i4.v,
					    menu_width.i4.v, menu_length.i4.v,
					    file_spec.i1a.r, file_name.i1a.r,
					    match.i1a.r, show_dir.i4.v
					    [,order_by.i4.v] [,options.u4.v])

	This routine displays directories of files.  It allows movement up
	and down the directories associated with the starting file string,
	"file_name".  It returns the user selected file name.

	x		x location of the upper left hand corner of the
			window relative to the parent graphic window
	y		y location of the upper left hand corner of the
			window relative to the parent graphic window
	coordinate_type	type of coordinate values passed
			(WN_WORLD_COORDS -> normal window world coordinates,
			 WN_PIXEL_COORDS -> raw pixel coordinates)
	menu_width	maximum width of menu
			(If a value of 0 is passed for this argument, this
			 routine will determine the appropriate menu width.)
	menu_length	maximum length of menu
	file_spec	desired file string, including disk and
			use of wildcards
			(ex: "/scratch/userb/pic/photos/objects/ *.gif")
	file_name	returned string of selected filename
			(caller should allocate 256 bytes for this)
	match		string to set default menu selection to
			(pass a value of NULL if no default is desired)
			(ex: "/scratch/userb/pic/photos/objects/diamond.gif")
	show_dir	when looking for wildcard filenames,
			parent and child directories displayed:
			(FILE_VIEW_NODIR  -> don't show parent and child,
			 FILE_VIEW_CHILD  -> show child directories,
			 FILE_VIEW_PARENT -> show parent directory,
			 FILE_VIEW_PARENT_CONSTRAIN -> show parent
						       directory but do not
						       allow access to root's
						       parent,
			 FILE_VIEW_FAMDIR -> show parent & child)
				--- or ---
			specify extended file information:
			(bitwise-OR values for composite information;
			 composite information shown in following order)
			(FILE_VIEW_CDATE  -> show file creation date,
			 FILE_VIEW_MDATE  -> show file modification date,
			 FILE_VIEW_CHANGE_DATE  -> show file change date,
			 FILE_VIEW_ACCESS_DATE  -> show file access date,
			 FILE_VIEW_SIZE   -> show file size)
				--- or ---
			specify special handling:
			(bitwise-OR values)
			(FILE_VIEW_NOMESS -> don't display a message window
					     if the requested directory is
					     empty)
	[order_by]	determine file order
			(FILE_VIEW_ORDER_BY_NAME -> order nby name
						    alphabetically (default),
			 FILE_VIEW_ORDER_BY_CREATION_DATE -> order by file
							     creation date)
	[options]	file viewing options
			(FILE_VIEW_OPT_NONE -> no options selected (default),
			 FILE_VIEW_OPT_INVERT_ORDER -> invert the sort order)

	This function returns ACNET status values as follows:

	OK			success
	CBS_MEMFAIL		failed in allocating dynamic memory
	CBS_INVARG		invalid file specification passed
	CBS_NO_SUCH		no files matched the requested specification
	CBS_INVSIZ		menu is too wide

	This function requires the following include files:

	cbslib_h, macro_h, acnet_errors_h

	Related functions:

	file_view_select, file_view_read, file_view_find, menu_setup_c,
	file_acknowledge_c, file_decide_c

	C/C++ usage:

	static const char	file_spec[] = "/some_path/";
	char	file_name[256];
	char	*match = (char *) NULL;
	int	status;
	int	coordinate_type = WN_PIXEL_COORDS;
	int	menu_width = MENU_WIDTH;
	int	menu_length = MENU_LENGTH;
	int	show_dir = FILE_VIEW_FAMDIR;
	int	order_by = FILE_VIEW_ORDER_BY_NAME;
	unsigned int	options = FILE_VIEW_OPT_NONE;
	double	x = 0;
	double	y = 0;

	status = wn_file_view_select_c(x,y,coordinate_type,menu_width,
				       menu_length,file_spec,file_name,
				       match,show_dir,order_by,options);