NAME

XSetNormalHints, XGetNormalHints - set or get normal state hints

SYNTAX

XSetNormalHints(display, w, hints)
      Display *display;
      Window w;
      XSizeHints *hints;

Status XGetNormalHints(display, w, hints_return)
      Display *display;
      Window w;
      XSizeHints *hints_return;

ARGUMENTS

display Specifies the connection to the XWIN server.

hints Specifies a pointer to the size hints for the window in its normal state.

hints_return

Returns the size hints for the window in its normal state.

w         Specifies the window.

DESCRIPTION

The XSetNormalHints function sets the size hints structure
for the specified window.  Applications use XSetNormalHints
to inform the window manager of the size or position desir-
able for that window.  In addition, an application that
wants to move or resize itself should call XSetNormalHints
and specify its new desired location and size as well as
making direct Xlib calls to move or resize. This is because
window managers may ignore redirected configure requests,
but they pay attention to property changes.

To set size hints, an application not only must assign
values to the appropriate members in the hints structure but
also must set the flags member of the structure to indicate
which information is present and where it came from. A call
to XSetNormalHints is meaningless, unless the flags member
is set to indicate which members of the structure have been
assigned values.

XSetNormalHints can generate BadAlloc and BadWindow errors.

     The XGetNormalHints function returns the size hints for a
     window in its normal state.  It returns a nonzero status if
     it succeeds or zero if the application specified no normal
     size hints for this window.

XWIN 3.0               Last change: 9/1/88                 .ie t

XGetNormalHints can generate a BadWindow error.

PROPERTY

WM_NORMAL_HINTS

DIAGNOSTICS

BadAlloc  The server failed to allocate the requested

resource or server memory.

BadWindow A value for a Window argument does not name a

defined Window.

SEE ALSO

     XSetCommand(3X11),
     XSetIconName(3X11),
     XSetIconSizeHints(3X11),
     XSetSizeHints(3X11),
     XSetStandardProperties(3X11),
     XSetWMHints(3X11),
     XSetZoomHints(3X11),
     XStoreName(3X11)
     Xlib - C Language X Interface

XWIN 3.0               Last change: 9/1/88                 .ie t

XWIN 3.0               Last change: 9/1/88                 .ie t