ac5d9ec558
On X11, mutter needs to keep a grab on the locate-pointer key to be able to trigger the functionality time the corresponding key combo is pressed. However, doing so may have side effects on other X11 clients that would want to have a grab on the same key. Make sure we only actually grab the key combo for "locate-pointer" only when the feature is actually enabled, so that having the locate pointer feature turned off (the default) would not cause side effects on other X11 clients that might want to use the same key for their own use. Fixes: https://gitlab.gnome.org/GNOME/mutter/issues/647
162 lines
4.9 KiB
C
162 lines
4.9 KiB
C
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*- */
|
|
|
|
/**
|
|
* \file keybindings.h Grab and ungrab keys, and process the key events
|
|
*
|
|
* Performs global X grabs on the keys we need to be told about, like
|
|
* the one to close a window. It also deals with incoming key events.
|
|
*/
|
|
|
|
/*
|
|
* Copyright (C) 2001 Havoc Pennington
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License as
|
|
* published by the Free Software Foundation; either version 2 of the
|
|
* License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful, but
|
|
* WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef META_KEYBINDINGS_PRIVATE_H
|
|
#define META_KEYBINDINGS_PRIVATE_H
|
|
|
|
#include <gio/gio.h>
|
|
#include <xkbcommon/xkbcommon.h>
|
|
|
|
#include "core/meta-accel-parse.h"
|
|
#include "meta/keybindings.h"
|
|
|
|
typedef struct _MetaKeyHandler MetaKeyHandler;
|
|
struct _MetaKeyHandler
|
|
{
|
|
char *name;
|
|
MetaKeyHandlerFunc func;
|
|
MetaKeyHandlerFunc default_func;
|
|
gint data, flags;
|
|
gpointer user_data;
|
|
GDestroyNotify user_data_free_func;
|
|
};
|
|
|
|
typedef struct _MetaResolvedKeyCombo {
|
|
xkb_keycode_t *keycodes;
|
|
int len;
|
|
xkb_mod_mask_t mask;
|
|
} MetaResolvedKeyCombo;
|
|
|
|
/**
|
|
* MetaKeyCombo:
|
|
* @keysym: keysym
|
|
* @keycode: keycode
|
|
* @modifiers: modifiers
|
|
*/
|
|
struct _MetaKeyCombo
|
|
{
|
|
unsigned int keysym;
|
|
unsigned int keycode;
|
|
MetaVirtualModifier modifiers;
|
|
};
|
|
|
|
struct _MetaKeyBinding
|
|
{
|
|
const char *name;
|
|
MetaKeyCombo combo;
|
|
MetaResolvedKeyCombo resolved_combo;
|
|
gint flags;
|
|
MetaKeyHandler *handler;
|
|
};
|
|
|
|
typedef struct
|
|
{
|
|
char *name;
|
|
GSettings *settings;
|
|
|
|
MetaKeyBindingAction action;
|
|
|
|
/*
|
|
* A list of MetaKeyCombos. Each of them is bound to
|
|
* this keypref. If one has keysym==modifiers==0, it is
|
|
* ignored.
|
|
*/
|
|
GSList *combos;
|
|
|
|
/* for keybindings not added with meta_display_add_keybinding() */
|
|
gboolean builtin:1;
|
|
} MetaKeyPref;
|
|
|
|
typedef struct _MetaKeyBindingKeyboardLayout
|
|
{
|
|
struct xkb_keymap *keymap;
|
|
xkb_layout_index_t index;
|
|
xkb_level_index_t n_levels;
|
|
} MetaKeyBindingKeyboardLayout;
|
|
|
|
typedef struct
|
|
{
|
|
MetaBackend *backend;
|
|
|
|
GHashTable *key_bindings;
|
|
GHashTable *key_bindings_index;
|
|
xkb_mod_mask_t ignored_modifier_mask;
|
|
xkb_mod_mask_t hyper_mask;
|
|
xkb_mod_mask_t virtual_hyper_mask;
|
|
xkb_mod_mask_t super_mask;
|
|
xkb_mod_mask_t virtual_super_mask;
|
|
xkb_mod_mask_t meta_mask;
|
|
xkb_mod_mask_t virtual_meta_mask;
|
|
MetaKeyCombo overlay_key_combo;
|
|
MetaResolvedKeyCombo overlay_resolved_key_combo;
|
|
gboolean overlay_key_only_pressed;
|
|
MetaKeyCombo locate_pointer_key_combo;
|
|
MetaResolvedKeyCombo locate_pointer_resolved_key_combo;
|
|
gboolean locate_pointer_key_only_pressed;
|
|
MetaResolvedKeyCombo iso_next_group_combo[2];
|
|
int n_iso_next_group_combos;
|
|
|
|
/*
|
|
* A primary layout, and an optional secondary layout for when the
|
|
* primary layout does not use the latin alphabet.
|
|
*/
|
|
MetaKeyBindingKeyboardLayout active_layouts[2];
|
|
|
|
/* Alt+click button grabs */
|
|
ClutterModifierType window_grab_modifiers;
|
|
} MetaKeyBindingManager;
|
|
|
|
void meta_display_init_keys (MetaDisplay *display);
|
|
void meta_display_shutdown_keys (MetaDisplay *display);
|
|
void meta_window_grab_keys (MetaWindow *window);
|
|
void meta_window_ungrab_keys (MetaWindow *window);
|
|
gboolean meta_window_grab_all_keys (MetaWindow *window,
|
|
guint32 timestamp);
|
|
void meta_window_ungrab_all_keys (MetaWindow *window,
|
|
guint32 timestamp);
|
|
gboolean meta_keybindings_process_event (MetaDisplay *display,
|
|
MetaWindow *window,
|
|
const ClutterEvent *event);
|
|
|
|
ClutterModifierType meta_display_get_window_grab_modifiers (MetaDisplay *display);
|
|
|
|
gboolean meta_prefs_add_keybinding (const char *name,
|
|
GSettings *settings,
|
|
MetaKeyBindingAction action,
|
|
MetaKeyBindingFlags flags);
|
|
|
|
gboolean meta_prefs_remove_keybinding (const char *name);
|
|
|
|
GList *meta_prefs_get_keybindings (void);
|
|
void meta_prefs_get_overlay_binding (MetaKeyCombo *combo);
|
|
void meta_prefs_get_locate_pointer_binding (MetaKeyCombo *combo);
|
|
const char *meta_prefs_get_iso_next_group_option (void);
|
|
gboolean meta_prefs_is_locate_pointer_enabled (void);
|
|
|
|
void meta_x11_display_grab_keys (MetaX11Display *x11_display);
|
|
void meta_x11_display_ungrab_keys (MetaX11Display *x11_display);
|
|
|
|
#endif
|