GR_WINDOW_INFO

Name

GR_WINDOW_INFO -- Retrieve window properties

Synopsis

typedef struct 
{
    GR_WINDOW_ID   wid;
    GR_WINDOW_ID   parent;
    GR_WINDOW_ID   child;
    GR_WINDOW_ID   sibling;
    GR_BOOL        inputonly;
    GR_BOOL        mapped;
    GR_COUNT       unmapcount;
    GR_COORD       x;
    GR_COORD       y;
    GR_SIZE        width;
    GR_SIZE        height;
    GR_SIZE        bordersize;
    GR_COLOR       bordercolor;
    GR_COLOR       background;
    GR_EVENT_MASK  eventmask;
    GR_WM_PROPS    props;
} GR_WINDOW_INFO;
  

Description

This stucture is used in conjuncion with the GrGetWindowInfo() function to return information about a window's current properties.

Fields

TypeNameDescription
GR_WINDOW_IDwidThe window ID of the window described in this structure, or 0 if the window passed to GrGetWindowInfo() is invalid.
GR_WINDOW_IDparentThe window ID of this window's parent window.
GR_WINDOW_IDchildThe window ID of this window's first child window. All of this window's child windows can be determined by obtaining window information on the first child, then the first child's next sibling, then that child's next sibling, etc.. This field will be zero if the window has no children.
GR_WINDOW_IDsiblingThe window ID of this windows's next sibling window. All child windows, of a particular parent, form a singly linked list. This field indicates the next child window in the list. This field will be zero if the window has no siblings, or is the last sibling in the linked list.
GR_BOOLinputonlyThis field is GR_TRUE if the window is an input only window.
GR_BOOLmappedThis field is GR_TRUE if the window is mapped (visible).
GR_COUNTunmapcountThe depth of unmapping for this window. When zero this window is visible. Each time the window is unmapped this field will increase, each time the window is mapped this field will decrement.
GR_COORDxThe X coordinate of the uper left corner of the window relative to the screen.
GR_COORDyThe Y coordinate of the uper left corner of the window relative to the screen.
GR_SIZEwidthThe width of the window.
GR_SIZEheightThe height of the window.
GR_SIZEbordersizeThe width of the window's border.
GR_COLORbordercolorThe color of the window's border.
GR_COLORbackgroundThe window's background color.
GR_EVENT_MASKeventmaskThe window's event mask. The value of this field indicates all events that the window is selected to receive (see GrSelectEvents()).
GR_WM_PROPSpropsThe window's window manager properties.

See Also

GrGetWindowInfo(), GR_SCREEN_INFO.