Introduces new configuration from to setup global shortcut entry. Allows also to use special key detection for headset button _for MS Windows only_.

1 files changed, 21 insertions, 0 deletions

diff --git a/src/net/java/sip/communicator/service/globalshortcut/GlobalShortcutService.java b/src/net/java/sip/communicator/service/globalshortcut/GlobalShortcutService.java
index 2753c92..f9f2cf3 100644
--- a/src/net/java/sip/communicator/service/globalshortcut/GlobalShortcutService.java
+++ b/src/net/java/sip/communicator/service/globalshortcut/GlobalShortcutService.java
@@ -17,6 +17,11 @@ import java.awt.*;
 public interface GlobalShortcutService
 {
     /**
+     * Value for AWTKeyStroke's modifiers that specify a "special" key shortcut.
+     */
+    public static final int SPECIAL_KEY_MODIFIERS = 16367;
+
+    /**
      * Registers an action to execute when the keystroke is typed.
      *
      * @param l listener to notify when keystroke is typed
@@ -35,6 +40,22 @@ public interface GlobalShortcutService
         AWTKeyStroke keyStroke);
 
     /**
+     * Enable or disable special key detection.
+     *
+     * @param enable enable or not special key detection.
+     * @param callback object to be notified
+     */
+    public void setSpecialKeyDetection(boolean enable,
+        GlobalShortcutListener callback);
+
+    /**
+     * Get special keystroke or null if not supported or user cancels.
+     *
+     * @return special keystroke or null if not supported or user cancels
+     */
+    public AWTKeyStroke getSpecialKey();
+
+    /**
      * Reload global shortcuts.
      */
     public void reloadGlobalShortcuts();