marco 1.29.1
Window manager
Loading...
Searching...
No Matches
window-props.h File Reference
View source

MetaWindow property handling. More...

#include "window-private.h"
Include dependency graph for window-props.h:
This graph shows which files directly or indirectly include this file:

Functions

void meta_window_reload_property (MetaWindow *window, Atom property, gboolean initial)
 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, gboolean initial)
 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, gboolean initial)
 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, gboolean initial)
 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.

Function Documentation

◆ meta_display_free_window_prop_hooks()

void meta_display_free_window_prop_hooks ( MetaDisplay *  display)

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

Parameters
displayThe display.

References NULL, _MetaDisplay::prop_hooks, and _MetaDisplay::prop_hooks_table.

Referenced by meta_display_close().

◆ meta_display_init_window_prop_hooks()

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.

Parameters
displayThe display.

Initialises the hooks used for the reload_propert* functions on a particular display, and stores a pointer to them in the display.

Each row in the table named "hooks" represents an action to take when a property is found on a newly-created window, or when a property changes its value.

The first column shows which atom the row concerns. The second gives the type of the property data. The property will be queried for its new value, unless the type is given as META_PROP_VALUE_INVALID, in which case nothing will be queried. The third column gives the name of a callback which gets called with the new value. (If the new value was not retrieved because the second column was META_PROP_VALUE_INVALID, the callback still gets called anyway.) This value may be NULL, in which case no callback will be called.

References complain_about_broken_client(), META_PROP_VALUE_ATOM_LIST, META_PROP_VALUE_CARDINAL, META_PROP_VALUE_CARDINAL_LIST, META_PROP_VALUE_CLASS_HINT, META_PROP_VALUE_INVALID, META_PROP_VALUE_MOTIF_HINTS, META_PROP_VALUE_SIZE_HINTS, META_PROP_VALUE_STRING, META_PROP_VALUE_SYNC_COUNTER, META_PROP_VALUE_TEXT_PROPERTY, META_PROP_VALUE_UTF8, META_PROP_VALUE_WINDOW, META_PROP_VALUE_WM_HINTS, NULL, _MetaDisplay::prop_hooks, _MetaDisplay::prop_hooks_table, MetaWindowPropHooks::property, reload_bamf_desktop_file(), reload_gtk_application_id(), reload_gtk_frame_extents(), reload_gtk_theme_variant(), reload_kwm_win_icon(), reload_mwm_hints(), reload_net_startup_id(), reload_net_wm_desktop(), reload_net_wm_icon(), reload_net_wm_icon_name(), reload_net_wm_name(), reload_net_wm_pid(), reload_net_wm_state(), reload_net_wm_user_time(), reload_net_wm_user_time_window(), reload_net_wm_window_type(), reload_normal_hints(), reload_struts(), reload_transient_for(), reload_update_counter(), reload_wm_class(), reload_wm_client_machine(), reload_wm_hints(), reload_wm_icon_name(), reload_wm_name(), reload_wm_protocols(), and reload_wm_window_role().

Referenced by meta_display_open().

Here is the call graph for this function:

◆ meta_set_normal_hints()

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
windowThe window to set the size hints on.
hintsEither some X size hints, or NULL for default.

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

Referenced by meta_window_new_with_attrs(), and reload_normal_hints().

◆ meta_window_reload_properties()

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

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
windowThe window.
propertiesA pointer to a list of X atoms, "n_properties" long.
n_propertiesThe length of the properties list.

References meta_window_reload_properties_from_xwindow(), and _MetaWindow::xwindow.

Referenced by meta_window_new_with_attrs(), and meta_window_reload_property().

Here is the call graph for this function:

◆ meta_window_reload_properties_from_xwindow()

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

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
windowA window on the same display as the one we're investigating (only used to find the display)
xwindowThe X handle for the window.
propertiesA pointer to a list of X atoms, "n_properties" long.
n_propertiesThe length of the properties list.

References MetaPropValue::atom, _MetaWindow::display, find_hooks(), meta_prop_free_values(), meta_prop_get_values(), META_PROP_VALUE_INVALID, NULL, MetaWindowPropHooks::reload_func, MetaWindowPropHooks::type, and MetaPropValue::type.

Referenced by meta_window_reload_properties(), and meta_window_reload_property_from_xwindow().

Here is the call graph for this function:

◆ meta_window_reload_property()

void meta_window_reload_property ( MetaWindow *  window,
Atom  property,
gboolean  initial 
)

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
windowThe window.
propertyA single X atom.

References meta_window_reload_properties().

Referenced by reload_net_wm_icon_name(), and reload_net_wm_name().

Here is the call graph for this function:

◆ meta_window_reload_property_from_xwindow()

void meta_window_reload_property_from_xwindow ( MetaWindow *  window,
Window  xwindow,
Atom  property,
gboolean  initial 
)

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
windowA window on the same display as the one we're investigating (only used to find the display)
xwindowThe X handle for the window.
propertyA single X atom.

References meta_window_reload_properties_from_xwindow().

Referenced by process_property_notify(), and reload_net_wm_user_time_window().

Here is the call graph for this function: