window_button_text_to_id_c

	status.i4.v = window_button_text_to_id_c(search_window.i2.v, text.i1a.r,
						 text_type.i4.v, button_id.i4.r)

	This routine returns the ID a window button having a given handle or
	label string.  A value of NULL can be passed for the returned ID
	argument.

	search_window	window ID to search
			(WMNGR_ALL_WINDOWS -> search all windows,
			 otherwise -> search specific window)
	text		null terminated ASCII string whose interpretation
			depends on "text_type"
	text_type	type of text to match
			(WINDOW_BUTTON_BY_HANDLE -> match text string to the
						    button handle,
			 WINDOW_BUTTON_BY_LABEL -> match text string to the
						   button label)
			(These values can be ORed together to make a
			 combined search.)
	button_id	returned button ID

	This function returns ACNET status values as follows:

	OK			success
	CBS_DUPREQ		multiple matches were found
				(data for the first match is returned)
	CBS_NO_SUCH		button doesn't exist

	This function requires the following include files:

	cnsparam_h, cbslib_h, acnet_errors_h

	Related functions:

	window_button_set_id_type_c, window_button_create_c,
	window_button_delete_c, window_button_enable_c,
	window_button_disable_c, window_button_highlight_c,
	window_button_unhighlight_c, intro_tv_windows

	C/C++ usage:

	static const char	text[] = "matching text";
	short	search_window = WMNGR_ALL_WINDOWS;
	int	status;
	int	text_type = WINDOW_BUTTON_BY_HANDLE;
	int	button_id;

	status = window_button_text_to_id_c(search_window,text,text_type,
					    &button_id);