window_align_top_row_to_window_c

	status.i4.v = window_align_top_row_to_window_c(window_id.i2.v, row.i4.v,
						       align_type.i4.v,
						       height.i4.v,
						       position_error.i4.v,
						       top_row.i4.r
						       [,calc_height.i4.r])

	This routine will shift a window's top row to center them
	relative to another window.  If any of the returned arguments
	are not needed, a value of NULL may be passed for them.

	window_id	window ID of reference window
	row		row of reference window
	align_type	type of centering (values can be logically ORed)
			(WMNGR_CENTER_VER -> center vertically relative
					     to the reference window only,
			 WMNGR_ALIGN_VERT -> align vertically only to the
					     passed row,
			 WMNGR_CENTER_ALIGN_VERT -> align vertically only
						    centering on the
						    passed row,
			 WMNGR_ALIGN_ABOVE -> position window above the
					      desired location,
			 WMNGR_ALIGN_BELOW -> position window below the
					      desired location,
			 WMNGR_ALIGN_ABOVE_OR_BELOW -> position window above or
						       below the desired
						       location depending upon
						       where there is sufficient
						       room,
			 WMNGR_ALIGN_ABOVE_WIN -> position window above the
						  reference window,
			 WMNGR_ALIGN_BELOW_WIN -> position window below the
						  reference window,
			 WMNGR_ALIGN_ABOVE_OR_BELOW_WIN -> position window above
							   or below the
							   reference window
							   depending upon where
							   there is sufficient
							   room)
			(macros are in 'macro')
	height		height of window
	position_error	indicates whether or not to return an error
			if the window cannot be located at the requested
			position
			(WMNGR_POS_ERROR_NONE -> don't return any errors
						 in position,
			 WMNGR_POS_ERROR_VERT -> return an error only if the
						 window cannot be placed in
						 the desired vertical
						 position,
			 WMNGR_POS_ERROR_BOTH -> return any positioning errors)
	top_row		returned top row of window
	[calc_height]	returned calculated window height

	This function returns status values as follows:

	OK			success
	CBS_WINDOW_TOO_BIG	window is too large
	CBS_NO_WINDOW		reference window does not exist
	CBS_NOT_IN_WINDOW	window cannot be place in the requested
				location

	This function requires the following include files:

	cnsparam_h, cbslib_h, macro_h

	Related functions:

	window_align_to_window_c, window_calc_top_row_c, center_window_c,
	shftwn, calc_window_c, window_construct(_c), window_create(_c),
	window_fit_window_c, window_unfit_window, window_size

	C/C++ usage:

	short	window_id;
	int	status;
	int	row = 1;
	int	align_type = WMNGR_CENTER_VER;
	int	height = WINDOW_HEIGHT;
	int	position_error = WMNGR_POS_ERROR_VERT;
	int	top_row;
	int	calc_height;

	status = window_align_top_row_to_window_c(window_id,row,align_type,
						  height,position_error,
						  &top_row,&calc_height);