XSetSizeHints(3X11)

Name

XSetSizeHints, XGetSizeHints − set or get window size hints

Syntax

XSetSizeHints(display, w, hints, property)
      Display *display;
      Window w;
      XSizeHints *hints;
      Atom property;

Status XGetSizeHints(display, w, hints_return, property)
      Display *display;
      Window w;
      XSizeHints *hints_return;
      Atom property;

Arguments

displaySpecifies the connection to the X server.

hintsSpecifies a pointer to the size hints.

hints_returnReturns the size hints.

propertySpecifies the property name.

wSpecifies the window.

Description

The XSetSizeHints function sets the XSizeHints structure for the named property and the specified window. This is used by XSetNormalHints and XSetZoomHints, and can be used to set the value of any property of type WM_SIZE_HINTS. Thus, it may be useful if other properties of that type get defined.

XSetSizeHints can generate BadAlloc, BadAtom, and BadWindow errors.

XGetSizeHints returns the XSizeHints structure for the named property and the specified window. This is used by XGetNormalHints and XGetZoomHints. It also can be used to retrieve the value of any property of type WM_SIZE_HINTS. Thus, it may be useful if other properties of that type get defined. XGetSizeHints returns a nonzero status if a size hint was defined or zero otherwise.

XGetSizeHints can generate BadAtom and BadWindow errors.

Diagnostics

BadAlloc The server failed to allocate the requested resource or server memory.

BadAtom A value for an Atom argument does not name a defined Atom.

BadWindow
A value for a Window argument does not name a defined Window.

Museum