Class
MetaWindow
Instance methods
meta_window_appears_focused
Determines if the window should be drawn with a focused appearance. This is true for focused windows but also true for windows with a focused modal dialog attached.
meta_window_client_rect_to_frame_rect
Converts a desired bounds of the client window into the corresponding bounds of the window frame (excluding invisible borders and client side shadows.)
meta_window_find_root_ancestor
Follow the chain of parents of window
, skipping transient windows,
and return the “root” window which has no non-transient parent.
meta_window_foreach_ancestor
If window
is transient, call func
with the window for which it’s transient,
repeatedly until either we find a non-transient window, or func
returns FALSE
.
meta_window_foreach_transient
Call func
for every window which is either transient for window
, or is
a transient of a window which is in turn transient for window
.
The order of window enumeration is not defined.
meta_window_frame_rect_to_client_rect
Converts a desired frame bounds for a window into the bounds of the client window.
meta_window_get_client_machine
Returns name of the client machine from which this windows was created, if known (obtained from the WM_CLIENT_MACHINE property).
meta_window_get_frame_rect
Gets the rectangle that bounds window
that is what the user thinks of
as the edge of the window. This doesn’t include any extra reactive
area that we or the client adds to the window, or any area that the
client adds to draw a client-side shadow.
meta_window_get_icon_geometry
Gets the location of the icon corresponding to the window. The location will be provided set by the task bar or other user interface element displaying the icon, and is relative to the root window.
meta_window_get_maximized
Gets the current maximization state of the window, as combination
of the META_MAXIMIZE_HORIZONTAL
and META_MAXIMIZE_VERTICAL
flags;
meta_window_get_pid
Returns the pid of the process that created this window, if available to the windowing system.
meta_window_get_sandboxed_app_id
Gets an unique id for a sandboxed app (currently flatpaks and snaps are supported).
meta_window_get_stable_sequence
The stable sequence number is a monotonicially increasing
unique integer assigned to each MetaWindow
upon creation.
meta_window_get_tile_match
Returns the matching tiled window on the same monitor as window
. This is
the topmost tiled window in a complementary tile mode that is:
meta_window_get_transient_for
Returns the MetaWindow
for the window that is pointed to by the
WM_TRANSIENT_FOR hint on this window (see XGetTransientForHint()
or XSetTransientForHint()). Mutter keeps transient windows above their
parents. A typical usage of this hint is for a dialog that wants to stay
above its associated window.
meta_window_get_user_time
The user time represents a timestamp for the last time the user interacted with this window. Note this property is only available for non-override-redirect windows.
meta_window_get_wm_class_instance
Return the current value of the instance part of WM_CLASS X property.
meta_window_get_work_area_for_monitor
Get the work area for window
, given the monitor index
which_monitor
.
meta_window_get_workspace
Gets the MetaWorkspace
that the window is currently displayed on.
If the window is on all workspaces, returns the currently active workspace.
meta_window_has_attached_dialogs
Tests if window
has any transients attached to it.
(If the “attach_modal_dialogs” option is not enabled, this will
always return FALSE
.)
meta_window_is_ancestor_of_transient
The function determines whether window
is an ancestor of transient
; it does
so by traversing the transient
‘s ancestors until it either locates window
or reaches an ancestor that is not transient.
meta_window_is_attached_dialog
Tests if window
should be attached to its parent window.
(If the “attach_modal_dialogs” option is not enabled, this will
always return FALSE
.)
meta_window_is_client_decorated
Check if if the window has decorations drawn by the client. (window->decorated refers only to whether we should add decorations)
meta_window_move_frame
Moves the window to the desired location on window’s assigned workspace, using the northwest edge of the frame as the reference, instead of the actual window’s origin, but only if a frame is present. Otherwise, acts identically to meta_window_move().
meta_window_move_resize_frame
Resizes the window so that its outer bounds (including frame) fit within the given rect.
meta_window_move_to_monitor
Moves the window to the monitor with index monitor
, keeping
the relative position of the window’s top left corner.
meta_window_set_icon_geometry
Sets or unsets the location of the icon corresponding to the window. If set, the location should correspond to a dock, task bar or other user interface element displaying the icon, and is relative to the root window.
Methods inherited from GInitable (1)
Signals
Meta.Window::position-changed
This is emitted when the position of a window might have changed. Specifically, this is emitted when the position of the toplevel window has changed, or when the position of the client window has changed.
Meta.Window::size-changed
This is emitted when the size of a window might have changed. Specifically, this is emitted when the size of the toplevel window has changed, or when the size of the client window has changed.
Signals inherited from GObject (1)
GObject::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.