Set_Geometry(4)

Set_Geometry(4)	 DEVICES AND NETWORK INTERFACES	  Set_Geometry(4)

NAME
     Set_Geometry request - set	a tool's on-screen geometry

SYNOPSIS
     Set_Geometry(inout	width w,
		  inout	height h,
		  inout	xOffset	x,
		  inout	yOffset	y
		  [in messageID	commission]);

DESCRIPTION
     The Set_Geometry request sets the on-screen geometry of  the
     optionally	 specified  window,  or	 of  the window	primarily
     associated	with the recipient procid (if no window	is speci-
     fied).

     The w, h, x and y arguments are integer geometry values,  in
     pixels,  representing  width,  height,  x-coordinate  and y-
     coordinate, respectively.	Negative offset	values are inter-
     preted  according	to  the	X11(7) man page.  If any of these
     arguments are unset, that part of the geometry need  not  be
     changed.	The  return  values are	the actual new values, in
     case they differ from the requested new values.

     The commission argument is	the ID of the ongoing request, if
     any,  that	 resulted  in the creation of the window in ques-
     tion.

APPLICATION USAGE
     The ttdt_session_join(3), and ttdt_message_accept(3),  func-
     tions  can	 be  used by Xt	applications to	register for, and
     transparently process, the	Set_Geometry request.

EXAMPLES
     The Set_Geometry request can be sent  as  in  the	following
     example:

	  Tt_message msg = tttk_message_create(0, TT_REQUEST, TT_SESSION,
		      the_recipient_procid, TTDT_SET_GEOMETRY,
		      my_callback);
	  tt_message_iarg_add(msg, TT_INOUT, Tttk_width, 500);
	  tt_message_iarg_add(msg, TT_INOUT, Tttk_height, 500);
	  tt_message_arg_add(msg, TT_INOUT, Tttk_xoffset, 0); /* no value */
	  tt_message_arg_add(msg, TT_INOUT, Tttk_yoffset, 0); /* no value */
	  tt_message_send(msg);

SEE ALSO
     tt_message_arg_add(3), tt_message_iarg_add(3),
     tt_message_send(3), ttdt_message_accept(3),
     ttdt_session_join(3); Get_Geometry	request.

Unix System LaboratorLast change: 13 May 1994			1