XSetNormalHints(3X11)                SysV                XSetNormalHints(3X11)



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 X 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 desirable 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.

     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