89363240eb
* SYNERGY-988 - Normalize scrolling direction on Mac * SYNERGY-988 - Scroll direction check on Windows * SYNERGY-988 - Add check for registry key presence * SYNERGY-988 - Normalize scrolling directino on Linux * SYNERGY-988 - Detach scroll direction check on Windows * SYNERGY-988 - Update changelog * SYNERGY-988 - Resolve code smells * SYNERGY-988 - Normalize scroll direction for Linux servers * SYNERGY-988 - Removed unnecessary INFO level logs Co-authored-by: SerhiiGadzhilov <71632867+SerhiiGadzhilov@users.noreply.github.com>
247 lines
8.7 KiB
C++
247 lines
8.7 KiB
C++
/*
|
|
* synergy -- mouse and keyboard sharing utility
|
|
* Copyright (C) 2012-2016 Symless Ltd.
|
|
* Copyright (C) 2002 Chris Schoeneman
|
|
*
|
|
* This package is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License
|
|
* found in the file LICENSE that should have accompanied this file.
|
|
*
|
|
* This package 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/>.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "synergy/DragInformation.h"
|
|
#include "synergy/clipboard_types.h"
|
|
#include "synergy/IScreen.h"
|
|
#include "synergy/IPrimaryScreen.h"
|
|
#include "synergy/ISecondaryScreen.h"
|
|
#include "synergy/IKeyState.h"
|
|
#include "synergy/option_types.h"
|
|
|
|
class IClipboard;
|
|
|
|
//! Screen interface
|
|
/*!
|
|
This interface defines the methods common to all platform dependent
|
|
screen implementations that are used by both primary and secondary
|
|
screens.
|
|
*/
|
|
class IPlatformScreen : public IScreen,
|
|
public IPrimaryScreen, public ISecondaryScreen,
|
|
public IKeyState {
|
|
public:
|
|
//! @name manipulators
|
|
//@{
|
|
|
|
IPlatformScreen(IEventQueue* events) : IKeyState(events) { }
|
|
|
|
//! Enable screen
|
|
/*!
|
|
Enable the screen, preparing it to report system and user events.
|
|
For a secondary screen it also means preparing to synthesize events
|
|
and hiding the cursor.
|
|
*/
|
|
virtual void enable() = 0;
|
|
|
|
//! Disable screen
|
|
/*!
|
|
Undoes the operations in enable() and events should no longer
|
|
be reported.
|
|
*/
|
|
virtual void disable() = 0;
|
|
|
|
//! Enter screen
|
|
/*!
|
|
Called when the user navigates to this screen.
|
|
*/
|
|
virtual void enter() = 0;
|
|
|
|
//! Leave screen
|
|
/*!
|
|
Called when the user navigates off the screen. Returns true on
|
|
success, false on failure. A typical reason for failure is being
|
|
unable to install the keyboard and mouse snoopers on a primary
|
|
screen. Secondary screens should not fail.
|
|
*/
|
|
virtual bool leave() = 0;
|
|
|
|
//! Set clipboard
|
|
/*!
|
|
Set the contents of the system clipboard indicated by \c id.
|
|
*/
|
|
virtual bool setClipboard(ClipboardID id, const IClipboard*) = 0;
|
|
|
|
//! Check clipboard owner
|
|
/*!
|
|
Check ownership of all clipboards and post grab events for any that
|
|
have changed. This is used as a backup in case the system doesn't
|
|
reliably report clipboard ownership changes.
|
|
*/
|
|
virtual void checkClipboards() = 0;
|
|
|
|
//! Open screen saver
|
|
/*!
|
|
Open the screen saver. If \c notify is true then this object must
|
|
send events when the screen saver activates or deactivates until
|
|
\c closeScreensaver() is called. If \c notify is false then the
|
|
screen saver is disabled and restored on \c closeScreensaver().
|
|
*/
|
|
virtual void openScreensaver(bool notify) = 0;
|
|
|
|
//! Close screen saver
|
|
/*!
|
|
// Close the screen saver. Stop reporting screen saver activation
|
|
and deactivation and, if the screen saver was disabled by
|
|
openScreensaver(), enable the screen saver.
|
|
*/
|
|
virtual void closeScreensaver() = 0;
|
|
|
|
//! Activate/deactivate screen saver
|
|
/*!
|
|
Forcibly activate the screen saver if \c activate is true otherwise
|
|
forcibly deactivate it.
|
|
*/
|
|
virtual void screensaver(bool activate) = 0;
|
|
|
|
//! Notify of options changes
|
|
/*!
|
|
Reset all options to their default values.
|
|
*/
|
|
virtual void resetOptions() = 0;
|
|
|
|
//! Notify of options changes
|
|
/*!
|
|
Set options to given values. Ignore unknown options and don't
|
|
modify options that aren't given in \c options.
|
|
*/
|
|
virtual void setOptions(const OptionsList& options) = 0;
|
|
|
|
//! Set clipboard sequence number
|
|
/*!
|
|
Sets the sequence number to use in subsequent clipboard events.
|
|
*/
|
|
virtual void setSequenceNumber(UInt32) = 0;
|
|
|
|
//! Change dragging status
|
|
virtual void setDraggingStarted(bool started) = 0;
|
|
|
|
//! Determine the name of the app causing a secure input state
|
|
/*!
|
|
On MacOS check which app causes a secure input state to be enabled. No alternative on other platforms
|
|
*/
|
|
virtual String getSecureInputApp() const = 0;
|
|
|
|
//! Allow updating wheel scrolling direction
|
|
/*!
|
|
Sets a flag to allow updating the scrolling direction automatically
|
|
when scrolling
|
|
*/
|
|
virtual void allowScrollDirectionUpdate() = 0;
|
|
|
|
//! Update the scrolling direction if allowed
|
|
/*!
|
|
If relevant flag is set should read a system settings to apply a
|
|
correct scrolling direction
|
|
*/
|
|
virtual void updateScrollDirection() = 0;
|
|
|
|
//@}
|
|
//! @name accessors
|
|
//@{
|
|
|
|
//! Test if is primary screen
|
|
/*!
|
|
Return true iff this screen is a primary screen.
|
|
*/
|
|
virtual bool isPrimary() const = 0;
|
|
|
|
//@}
|
|
|
|
// IScreen overrides
|
|
virtual void* getEventTarget() const = 0;
|
|
virtual bool getClipboard(ClipboardID id, IClipboard*) const = 0;
|
|
virtual void getShape(SInt32& x, SInt32& y,
|
|
SInt32& width, SInt32& height) const = 0;
|
|
virtual void getCursorPos(SInt32& x, SInt32& y) const = 0;
|
|
|
|
// IPrimaryScreen overrides
|
|
virtual void reconfigure(UInt32 activeSides) = 0;
|
|
virtual void warpCursor(SInt32 x, SInt32 y) = 0;
|
|
virtual UInt32 registerHotKey(KeyID key, KeyModifierMask mask) = 0;
|
|
virtual void unregisterHotKey(UInt32 id) = 0;
|
|
virtual void fakeInputBegin() = 0;
|
|
virtual void fakeInputEnd() = 0;
|
|
virtual SInt32 getJumpZoneSize() const = 0;
|
|
virtual bool isAnyMouseButtonDown(UInt32& buttonID) const = 0;
|
|
virtual void getCursorCenter(SInt32& x, SInt32& y) const = 0;
|
|
|
|
// ISecondaryScreen overrides
|
|
virtual void fakeMouseButton(ButtonID id, bool press) = 0;
|
|
virtual void fakeMouseMove(SInt32 x, SInt32 y) = 0;
|
|
virtual void fakeMouseRelativeMove(SInt32 dx, SInt32 dy) const = 0;
|
|
virtual void fakeMouseWheel(SInt32 xDelta, SInt32 yDelta) const = 0;
|
|
|
|
// IKeyState overrides
|
|
virtual void updateKeyMap() = 0;
|
|
virtual void updateKeyState() = 0;
|
|
virtual void setHalfDuplexMask(KeyModifierMask) = 0;
|
|
virtual void fakeKeyDown(KeyID id, KeyModifierMask mask,
|
|
KeyButton button) = 0;
|
|
virtual bool fakeKeyRepeat(KeyID id, KeyModifierMask mask,
|
|
SInt32 count, KeyButton button) = 0;
|
|
virtual bool fakeKeyUp(KeyButton button) = 0;
|
|
virtual void fakeAllKeysUp() = 0;
|
|
virtual bool fakeCtrlAltDel() = 0;
|
|
virtual bool fakeMediaKey(KeyID id);
|
|
virtual bool isKeyDown(KeyButton) const = 0;
|
|
virtual KeyModifierMask
|
|
getActiveModifiers() const = 0;
|
|
virtual KeyModifierMask
|
|
pollActiveModifiers() const = 0;
|
|
virtual SInt32 pollActiveGroup() const = 0;
|
|
virtual void pollPressedKeys(KeyButtonSet& pressedKeys) const = 0;
|
|
|
|
virtual String& getDraggingFilename() = 0;
|
|
virtual void clearDraggingFilename() = 0;
|
|
virtual bool isDraggingStarted() = 0;
|
|
virtual bool isFakeDraggingStarted() = 0;
|
|
|
|
virtual void fakeDraggingFiles(DragFileList fileList) = 0;
|
|
virtual const String&
|
|
getDropTarget() const = 0;
|
|
|
|
protected:
|
|
//! Handle system event
|
|
/*!
|
|
A platform screen is expected to install a handler for system
|
|
events in its c'tor like so:
|
|
\code
|
|
m_events->adoptHandler(Event::kSystem,
|
|
m_events->getSystemTarget(),
|
|
new TMethodEventJob<CXXXPlatformScreen>(this,
|
|
&CXXXPlatformScreen::handleSystemEvent));
|
|
\endcode
|
|
It should remove the handler in its d'tor. Override the
|
|
\c handleSystemEvent() method to process system events.
|
|
It should post the events \c IScreen as appropriate.
|
|
|
|
A primary screen has further responsibilities. It should post
|
|
the events in \c IPrimaryScreen as appropriate. It should also
|
|
call \c onKey() on its \c KeyState whenever a key is pressed
|
|
or released (but not for key repeats). And it should call
|
|
\c updateKeyMap() on its \c KeyState if necessary when the keyboard
|
|
mapping changes.
|
|
|
|
The target of all events should be the value returned by
|
|
\c getEventTarget().
|
|
*/
|
|
virtual void handleSystemEvent(const Event& event, void*) = 0;
|
|
};
|