window-props.h File Reference

MetaWindow property handling. More...

Go to the source code of this file.

Functions

void meta_window_reload_property (MetaWindow *window, Atom property)
 Requests the current values of a single property for a given window from the server, and deals with it appropriately.
void meta_window_reload_properties (MetaWindow *window, const Atom *properties, int n_properties)
 Requests the current values of a set of properties for a given window from the server, and deals with them appropriately.
void meta_window_reload_property_from_xwindow (MetaWindow *window, Window xwindow, Atom property)
 Requests the current values of a single property for a given window from the server, and deals with it appropriately.
void meta_window_reload_properties_from_xwindow (MetaWindow *window, Window xwindow, const Atom *properties, int n_properties)
 Requests the current values of a set of properties for a given window from the server, and deals with them appropriately.
void meta_display_init_window_prop_hooks (MetaDisplay *display)
 Initialises the hooks used for the reload_propert* functions on a particular display, and stores a pointer to them in the display.
void meta_display_free_window_prop_hooks (MetaDisplay *display)
 Frees the hooks used for the reload_propert* functions for a particular display.
void meta_set_normal_hints (MetaWindow *window, XSizeHints *hints)
 Sets the size hints for a window.


Detailed Description

MetaWindow property handling.

A system which can inspect sets of properties of given windows and take appropriate action given their values.

Note that all the meta_window_reload_propert* functions require a round trip to the server.

Definition in file window-props.h.


Function Documentation

void meta_display_free_window_prop_hooks ( MetaDisplay display  ) 

Frees the hooks used for the reload_propert* functions for a particular display.

Parameters:
display The display.

Definition at line 1606 of file window-props.c.

References NULL, and _MetaDisplay::prop_hooks.

Referenced by meta_display_close().

void meta_display_init_window_prop_hooks ( MetaDisplay display  ) 

void meta_set_normal_hints ( MetaWindow window,
XSizeHints *  hints 
)

Sets the size hints for a window.

This happens when a WM_NORMAL_HINTS property is set on a window, but it is public because the size hints are set to defaults when a window is created. See http://tronche.com/gui/x/icccm/sec-4.html#WM_NORMAL_HINTS for the X details.

Parameters:
window The window to set the size hints on.
hints Either some X size hints, or NULL for default.

Definition at line 928 of file window-props.c.

References _MetaWindow::desc, META_DEBUG_GEOMETRY, and _MetaWindow::size_hints.

Referenced by meta_window_new_with_attrs(), and reload_normal_hints().

void meta_window_reload_properties ( MetaWindow window,
const Atom *  properties,
int  n_properties 
)

Requests the current values of a set of properties for a given window from the server, and deals with them appropriately.

Does not return them to the caller (they've been dealt with!)

Parameters:
window The window.
properties A pointer to a list of X atoms, "n_properties" long.
n_properties The length of the properties list.

Definition at line 83 of file window-props.c.

References meta_window_reload_properties_from_xwindow(), and _MetaWindow::xwindow.

Referenced by meta_window_new_with_attrs(), and meta_window_reload_property().

void meta_window_reload_properties_from_xwindow ( MetaWindow window,
Window  xwindow,
const Atom *  properties,
int  n_properties 
)

Requests the current values of a set of properties for a given window from the server, and deals with them appropriately.

Does not return them to the caller (they've been dealt with!)

Parameters:
window A window on the same display as the one we're investigating (only used to find the display)
xwindow The X handle for the window.
properties A pointer to a list of X atoms, "n_properties" long.
n_properties The length of the properties list.

Definition at line 102 of file window-props.c.

References _MetaWindow::display, init_prop_value(), meta_prop_free_values(), meta_prop_get_values(), NULL, and reload_prop_value().

Referenced by meta_window_reload_properties(), and meta_window_reload_property_from_xwindow().

void meta_window_reload_property ( MetaWindow window,
Atom  property 
)

Requests the current values of a single property for a given window from the server, and deals with it appropriately.

Does not return it to the caller (it's been dealt with!)

Parameters:
window The window.
property A single X atom.

Definition at line 76 of file window-props.c.

References meta_window_reload_properties().

Referenced by process_property_notify().

void meta_window_reload_property_from_xwindow ( MetaWindow window,
Window  xwindow,
Atom  property 
)

Requests the current values of a single property for a given window from the server, and deals with it appropriately.

Does not return it to the caller (it's been dealt with!)

Parameters:
window A window on the same display as the one we're investigating (only used to find the display)
xwindow The X handle for the window.
property A single X atom.

Definition at line 94 of file window-props.c.

References meta_window_reload_properties_from_xwindow().

Referenced by process_property_notify(), and reload_net_wm_user_time_window().


Generated on Sat Aug 23 22:04:22 2008 for metacity by  doxygen 1.5.5