Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

NAME

XGetNormalHints − get the size hints property of a window in normal state (not zoomed or iconified). 

Synopsis

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

Arguments

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

wSpecifies the ID of the window to be queried. 

hints_return
Returns the sizing hints for the window in its normal state.

Description

XGetNormalHints() has been superseded by XGetWMNormalHints() as of Release 4, because new interclient communication conventions are now standard.  XGetNormalHints() returns the size hints for a window in its normal state by reading the XA_WM_NORMAL_HINTS property.  This function is normally used only by a window manager.  It returns a nonzero Status if it succeeds, and zero if it fails (e.g., the application specified no normal size hints for this window.)  For more information on using hints, see Volume One, Chapter 10, Interclient Communication. 

Structures

typedef struct {
long flags;   /* which fields in structure are defined */
int x, y;
int width, height;
int min_width, min_height;
int max_width, max_height;
int width_inc, height_inc;
struct {
    int x;/* numerator */
    int y;/* denominator */
} min_aspect, max_aspect;
} XSizeHints;
 /* flags argument in size hints */
#define USPosition(1L << 0) /* user specified x, y */
#define USSize(1L << 1) /* user specified width, height */
 #define PPosition(1L << 2) /* program specified position */
#define PSize(1L << 3) /* program specified size */
#define PMinSize(1L << 4) /* program specified minimum size */
#define PMaxSize(1L << 5) /* program specified maximum size */
#define PResizeInc(1L << 6) /* program specified resize increments */
#define PAspect(1L << 7) /* program specified min/max aspect ratios */
#define PAllHints (PPosition|PSize|PMinSize|PMaxSize|PResizeInc|PAspect)

Errors

BadWindow

See Also

XGetClassHint(), XGetIconSizes(), XGetSizeHints(), XGetTransientForHint(), XGetWMHints(), XGetZoomHints(), XSetClassHint(), XSetCommand(), XSetIconSizes(), XSetNormalHints(), XSetSizeHints(), XSetTransientForHint(), XSetWMHints(), XSetZoomHints(),

Copyright O’Reilly & Assoc.  —  

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026