window_align_to_window_c

	status.i4.v = window_align_to_window_c(window_id.i2.v, row.i4.v,
					       column.i4.v, align_type.i4.v,
					       width.i4.v, height.i4.v,
					       position_error.i4.v,
					       left_column.i4.r, top_row.i4.r,
					       right_column.i4.r,
					       bottom_row.i4.r)

	This routine will shift a window's coordinates 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 (only used for WMNGR_ALIGN_VERT
			and WMNGR_ALIGN_BOTH)
	column		column of reference window (only used for
			WMNGR_ALIGN_HORZ and WMNGR_ALIGN_BOTH)
	align_type	type of centering (values can be logically ORed)
			(WMNGR_CENTER_HOR -> center horizontally relative
					     to the reference window only,
			 WMNGR_CENTER_VER -> center vertically relative
					     to the reference window only,
			 WMNGR_CENTER_BOTH -> center relative to the reference
					      window in both planes,
			 WMNGR_ALIGN_HORZ -> align horizontally only to the
					     passed column,
			 WMNGR_ALIGN_VERT -> align vertically only to the
					     passed row,
			 WMNGR_ALIGN_BOTH -> align in both planes to the
					     passed window coordinates,
			 WMNGR_CENTER_ALIGN_HORZ -> align horizontally only
						    centering on the
						    passed column,
			 WMNGR_CENTER_ALIGN_VERT -> align vertically only
						    centering on the
						    passed row,
			 WMNGR_CENTER_ALIGN_BOTH -> align in both planes
						    centering on the
						    passed window coordinates,
			 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 based upon where
						       there is sufficient room,
			 WMNGR_ALIGN_LEFT -> position window to the left of
					     the desired location,
			 WMNGR_ALIGN_RIGHT -> position window to the right of
					      the desired location,
			 WMNGR_ALIGN_LEFT_OR_RIGHT -> position window to the
						      left or right of the
						      desired location based
						      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
							   based upon where
							   there is sufficient
							   room,
			 WMNGR_ALIGN_LEFT_WIN -> position window to the left of
						 the reference window,
			 WMNGR_ALIGN_RIGHT_WIN -> position window to the right
						  of the reference window,
			 WMNGR_ALIGN_LEFT_OR_RIGHT_WIN -> position window to the
							  left or right of the
							  reference window based
							  upon where there is
							  sufficient room)
			(macros can be found in 'macro')
	width		width of window
	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_HORZ -> return an error only if the
						 window cannot be placed in
						 the desired horizontal
						 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)
	left_column	returned left column of window
	top_row		returned top row of window
	right_column	returned right column of window
	bottom_row	returned bottom row of window

	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:

	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	column = 1;
	int	align_type = WMNGR_CENTER_BOTH;
	int	width = WINDOW_WIDTH;
	int	height = WINDOW_HEIGHT;
	int	position_error = WMNGR_POS_ERROR_BOTH;
	int	left_column;
	int	top_row;
	int	right_column;
	int	bottom_row;

	status = window_align_to_window_c(window_id,row,column,align_type,
					  width,height,position_error,
					  &left_column,&top_row,
					  &right_column,&bottom_row);