Top | ![]() |
![]() |
![]() |
![]() |
void | accelerator-activated | Run Last |
void | grab-op-begin | Run Last |
void | grab-op-end | Run Last |
gboolean | modifiers-accelerator-activated | Run Last |
void | overlay-key | Run Last |
void | window-created | Run Last |
void | window-demands-attention | Run Last |
void | window-marked-urgent | Run Last |
void meta_display_get_compositor_version (MetaDisplay *display
,int *major
,int *minor
);
gboolean
meta_display_supports_extended_barriers
(MetaDisplay *display
);
MetaWindow *
meta_display_get_focus_window (MetaDisplay *display
);
Get our best guess as to the "currently" focused window (that is, the window that we expect will be focused at the point when the X server processes our next request).
gboolean meta_display_xwindow_is_a_no_focus_window (MetaDisplay *display
,Window xwindow
);
int
meta_display_get_damage_event_base (MetaDisplay *display
);
gboolean meta_display_xserver_time_is_before (MetaDisplay *display
,guint32 time1
,guint32 time2
);
Xserver time can wraparound, thus comparing two timestamps needs to take this into account. If no wraparound has occurred, this is equivalent to time1 < time2 Otherwise, we need to account for the fact that wraparound can occur and the fact that a timestamp of 0 must be special-cased since it means "older than anything else".
Note that this is NOT an equivalent for time1 <= time2; if that's what you need then you'll need to swap the order of the arguments and negate the result.
guint32
meta_display_get_current_time_roundtrip
(MetaDisplay *display
);
GList * meta_display_get_tab_list (MetaDisplay *display
,MetaTabList type
,MetaScreen *screen
,MetaWorkspace *workspace
);
Determine the list of windows that should be displayed for Alt-TAB
functionality. The windows are returned in most recently used order.
If workspace
is not NULL
, the list only conains windows that are on
workspace
or have the demands-attention hint set; otherwise it contains
all windows on screen
.
MetaWindow * meta_display_get_tab_next (MetaDisplay *display
,MetaTabList type
,MetaWorkspace *workspace
,MetaWindow *window
,gboolean backward
);
Determine the next window that should be displayed for Alt-TAB functionality.
MetaWindow * meta_display_get_tab_current (MetaDisplay *display
,MetaTabList type
,MetaWorkspace *workspace
);
Determine the active window that should be displayed for Alt-TAB.
gboolean meta_display_begin_grab_op (MetaDisplay *display
,MetaScreen *screen
,MetaWindow *window
,MetaGrabOp op
,gboolean pointer_already_grabbed
,gboolean frame_action
,int button
,gulong modmask
,guint32 timestamp
,int root_x
,int root_y
);
void meta_display_end_grab_op (MetaDisplay *display
,guint32 timestamp
);
MetaGrabOp
meta_display_get_grab_op (MetaDisplay *display
);
Gets the current grab operation, if any.
the current grab operation, or META_GRAB_OP_NONE
if
Mutter doesn't currently have a grab. META_GRAB_OP_COMPOSITOR
will
be returned if a compositor-plugin modal operation is in effect
(See mutter_begin_modal_for_plugin()
)
guint meta_display_add_keybinding (MetaDisplay *display
,const char *name
,GSettings *settings
,MetaKeyBindingFlags flags
,MetaKeyHandlerFunc handler
,gpointer user_data
,GDestroyNotify free_data
);
Add a keybinding at runtime. The key name
in schema
needs to be of
type G_VARIANT_TYPE_STRING_ARRAY
, with each string describing a
keybinding in the form of "<Control>a" or "<Shift><Alt>F1". The parser
is fairly liberal and allows lower or upper case, and also abbreviations
such as "<Ctl>" and "<Ctrl>". If the key is set to the empty list or a
list with a single element of either "" or "disabled", the keybinding is
disabled.
If META_KEY_BINDING_REVERSES
is specified in flags
, the binding
may be reversed by holding down the "shift" key; therefore, "<Shift>"
cannot be one of the keys used. handler
is expected to check for the
"shift" modifier in this case and reverse its action.
Use meta_display_remove_keybinding()
to remove the binding.
display |
||
name |
the binding's name |
|
settings |
the GSettings object where |
|
flags |
flags to specify binding details |
|
handler |
function to run when the keybinding is invoked |
|
user_data |
the data to pass to |
|
free_data |
function to free |
the corresponding keybinding action if the keybinding was
added successfully, otherwise META_KEYBINDING_ACTION_NONE
gboolean meta_display_remove_keybinding (MetaDisplay *display
,const char *name
);
Remove keybinding name
; the function will fail if name
is not a known
keybinding or has not been added with meta_display_add_keybinding()
.
guint meta_display_get_keybinding_action (MetaDisplay *display
,unsigned int keycode
,unsigned long mask
);
Get the keybinding action bound to keycode
. Builtin keybindings
have a fixed associated MetaKeyBindingAction, for bindings added
dynamically the function will return the keybinding action
meta_display_add_keybinding()
returns on registration.
void meta_display_set_input_focus_window (MetaDisplay *display
,MetaWindow *window
,gboolean focus_frame
,guint32 timestamp
);
void meta_display_focus_the_no_focus_window (MetaDisplay *display
,MetaScreen *screen
,guint32 timestamp
);
GSList * meta_display_sort_windows_by_stacking (MetaDisplay *display
,GSList *windows
);
Sorts a set of windows according to their current stacking order. If windows from multiple screens are present in the set of input windows, then all the windows on screen 0 are sorted below all the windows on screen 1, and so forth. Since the stacking order of override-redirect windows isn't controlled by Metacity, if override-redirect windows are in the input, the result may not correspond to the actual stacking order in the X server.
An example of using this would be to sort the list of transient dialogs for a window into their current stacking order.
void meta_display_add_ignored_crossing_serial (MetaDisplay *display
,unsigned long serial
);
Save the specified serial and ignore crossing events with that serial for the purpose of focus-follows-mouse. This can be used for certain changes to the window hierarchy that we don't want to change the focus window, even if they cause the pointer to end up in a new window.
void meta_display_unmanage_screen (MetaDisplay *display
,MetaScreen *screen
,guint32 timestamp
);
void
meta_display_clear_mouse_mode (MetaDisplay *display
);
Sets the mouse-mode flag to FALSE
, which means that motion events are
no longer ignored in mouse or sloppy focus.
This is an internal function. It should be used only for reimplementing
keybindings, and only in a manner compatible with core code.
“accelerator-activated”
signalvoid user_function (MetaDisplay *metadisplay, guint arg1, guint arg2, guint arg3, gpointer user_data)
Flags: Run Last
“grab-op-begin”
signalvoid user_function (MetaDisplay *metadisplay, MetaScreen *arg1, MetaWindow *arg2, MetaGrabOp arg3, gpointer user_data)
Flags: Run Last
“grab-op-end”
signalvoid user_function (MetaDisplay *metadisplay, MetaScreen *arg1, MetaWindow *arg2, MetaGrabOp arg3, gpointer user_data)
Flags: Run Last
“modifiers-accelerator-activated”
signalgboolean user_function (MetaDisplay *display, gpointer user_data)
The ::modifiers-accelerator-activated signal will be emitted when a special modifiers-only keybinding is activated.
display |
the MetaDisplay instance |
|
user_data |
user data set when the signal handler was connected. |
TRUE
means that the keyboard device should remain
frozen and FALSE
for the default behavior of unfreezing the
keyboard.
Flags: Run Last
“overlay-key”
signalvoid user_function (MetaDisplay *metadisplay, gpointer user_data)
Flags: Run Last
“window-created”
signalvoid user_function (MetaDisplay *metadisplay, MetaWindow *arg1, gpointer user_data)
Flags: Run Last
“window-demands-attention”
signalvoid user_function (MetaDisplay *metadisplay, MetaWindow *arg1, gpointer user_data)
Flags: Run Last
“window-marked-urgent”
signalvoid user_function (MetaDisplay *metadisplay, MetaWindow *arg1, gpointer user_data)
Flags: Run Last