LibreOffice Module vcl (master)  1
unx/salframe.h
Go to the documentation of this file.
1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2 /*
3  * This file is part of the LibreOffice project.
4  *
5  * This Source Code Form is subject to the terms of the Mozilla Public
6  * License, v. 2.0. If a copy of the MPL was not distributed with this
7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
8  *
9  * This file incorporates work covered by the following license notice:
10  *
11  * Licensed to the Apache Software Foundation (ASF) under one or more
12  * contributor license agreements. See the NOTICE file distributed
13  * with this work for additional information regarding copyright
14  * ownership. The ASF licenses this file to you under the Apache
15  * License, Version 2.0 (the "License"); you may not use this file
16  * except in compliance with the License. You may obtain a copy of
17  * the License at http://www.apache.org/licenses/LICENSE-2.0 .
18  */
19 
20 #ifndef INCLUDED_VCL_INC_UNX_SALFRAME_H
21 #define INCLUDED_VCL_INC_UNX_SALFRAME_H
22 
23 #include <X11/Xlib.h>
24 
25 #include <unx/saltype.h>
26 #include <unx/saldisp.hxx>
28 #include <salframe.hxx>
29 #include <salwtype.hxx>
30 #include <salinst.hxx>
31 
32 #include <vcl/ptrstyle.hxx>
33 #include <vcl/sysdata.hxx>
34 #include <vcl/timer.hxx>
35 #include <vclpluginapi.h>
36 
37 #include <list>
38 
39 class X11SalGraphics;
41 
42 namespace vcl_sal { class WMAdaptor; class NetWMAdaptor; class GnomeWMAdaptor; }
43 
44 // X11SalFrame
45 #define SHOWSTATE_UNKNOWN -1
46 #define SHOWSTATE_MINIMIZED 0
47 #define SHOWSTATE_NORMAL 1
48 #define SHOWSTATE_HIDDEN 2
49 
50 enum class WMWindowType
51 {
52  Normal,
54  Utility,
55  Splash,
56  Toolbar,
57  Dock
58 };
59 
60 class X11SalFrame final : public SalFrame
61 {
62  friend class vcl_sal::WMAdaptor;
63  friend class vcl_sal::NetWMAdaptor;
65 
66  X11SalFrame* mpParent; // pointer to parent frame
67  // which should never obscure this frame
69  std::list< X11SalFrame* > maChildren; // List of child frames
70 
73  ::Window mhWindow;
74  ::Window mhShellWindow;
75  ::Window mhForeignParent;
76  // window to fall back to when no longer in fullscreen mode
77  ::Window mhStackingWindow;
78  // window to listen for CirculateNotify events
79 
81  int nCaptured_; // is captured
82 
83  std::unique_ptr<X11SalGraphics> pGraphics_; // current frame graphics
84  std::unique_ptr<X11SalGraphics> pFreeGraphics_; // first free frame graphics
85 
88 
89  int nShowState_; // show state
90  int nWidth_; // client width
91  int nHeight_; // client height
96  bool bViewable_;
97  bool bMapped_;
98  bool bDefaultPosition_; // client is centered initially
99  bool m_bXEmbed;
103 
106 
108 
109  // data for WMAdaptor
114 
115  // icon id
116  int mnIconID;
117 
118  OUString m_aTitle;
119 
120  OUString m_sWMClass;
121 
123 
124  std::unique_ptr<SalI18N_InputContext> mpInputContext;
126 
127  std::vector<XRectangle> m_vClipRectangles;
128 
130 
131  void GetPosSize( tools::Rectangle &rPosSize );
132  void SetSize ( const Size &rSize );
133  void Center();
134  void SetPosSize( const tools::Rectangle &rPosSize );
135  void Minimize();
136  void Maximize();
137  void Restore();
138 
139  void RestackChildren( ::Window* pTopLevelWindows, int nTopLevelWindows );
140  void RestackChildren();
141 
142  bool HandleKeyEvent ( XKeyEvent *pEvent );
143  bool HandleMouseEvent ( XEvent *pEvent );
144  bool HandleFocusEvent ( XFocusChangeEvent const *pEvent );
145  bool HandleExposeEvent ( XEvent const *pEvent );
146  bool HandleSizeEvent ( XConfigureEvent *pEvent );
147  bool HandleStateEvent ( XPropertyEvent const *pEvent );
148  bool HandleReparentEvent ( XReparentEvent *pEvent );
149  bool HandleClientMessage ( XClientMessageEvent*pEvent );
150 
151  DECL_LINK( HandleAlwaysOnTopRaise, Timer*, void );
152 
153  void createNewWindow( ::Window aParent, SalX11Screen nXScreen = SalX11Screen( -1 ) );
154  void updateScreenNumber();
155 
156  void setXEmbedInfo();
157  void askForXEmbedFocus( sal_Int32 i_nTimeCode );
158 
159  void updateWMClass();
160 public:
161  X11SalFrame( SalFrame* pParent, SalFrameStyleFlags nSalFrameStyle, SystemParentData const * pSystemParent = nullptr );
162  virtual ~X11SalFrame() override;
163 
164  bool Dispatch( XEvent *pEvent );
165  void Init( SalFrameStyleFlags nSalFrameStyle, SalX11Screen nScreen,
166  SystemParentData const * pParentData, bool bUseGeometry = false );
167 
169  {
170  return pDisplay_;
171  }
173  {
174  return pDisplay_->GetDisplay();
175  }
176  const SalX11Screen& GetScreenNumber() const { return m_nXScreen; }
177  ::Window GetWindow() const { return mhWindow; }
178  ::Window GetShellWindow() const { return mhShellWindow; }
179  ::Window GetForeignParent() const { return mhForeignParent; }
180  ::Window GetStackingWindow() const { return mhStackingWindow; }
181  void Close() const { CallCallback( SalEvent::Close, nullptr ); }
182  SalFrameStyleFlags GetStyle() const { return nStyle_; }
183 
184  Cursor GetCursor() const { return hCursor_; }
185  bool IsCaptured() const { return nCaptured_ == 1; }
186 #if !defined(__synchronous_extinput__)
187  void HandleExtTextEvent (XClientMessageEvent const *pEvent);
188 #endif
189  bool IsOverrideRedirect() const;
190  bool IsChildWindow() const { return bool(nStyle_ & (SalFrameStyleFlags::PLUG|SalFrameStyleFlags::SYSTEMCHILD)); }
191  bool IsSysChildWindow() const { return bool(nStyle_ & SalFrameStyleFlags::SYSTEMCHILD); }
192  bool IsFloatGrabWindow() const;
193  SalI18N_InputContext* getInputContext() const { return mpInputContext.get(); }
194  bool hasFocus() const { return mbInputFocus; }
195 
196  void beginUnicodeSequence();
198  bool endUnicodeSequence();
199 
200  virtual SalGraphics* AcquireGraphics() override;
201  virtual void ReleaseGraphics( SalGraphics* pGraphics ) override;
202 
203  // call with true to clear graphics (setting None as drawable)
204  // call with false to setup graphics with window (GetWindow())
205  virtual void updateGraphics( bool bClear );
206 
207  virtual bool PostEvent(std::unique_ptr<ImplSVEvent> pData) override;
208 
209  virtual void SetTitle( const OUString& rTitle ) override;
210  virtual void SetIcon( sal_uInt16 nIcon ) override;
211  virtual void SetMenu( SalMenu* pMenu ) override;
212  virtual void DrawMenuBar() override;
213 
214  virtual void SetExtendedFrameStyle( SalExtStyle nExtStyle ) override;
215  virtual void Show( bool bVisible, bool bNoActivate = false ) override;
216  virtual void SetMinClientSize( tools::Long nWidth, tools::Long nHeight ) override;
217  virtual void SetMaxClientSize( tools::Long nWidth, tools::Long nHeight ) override;
218  virtual void SetPosSize( tools::Long nX, tools::Long nY, tools::Long nWidth, tools::Long nHeight, sal_uInt16 nFlags ) override;
219  virtual void GetClientSize( tools::Long& rWidth, tools::Long& rHeight ) override;
220  virtual void GetWorkArea( tools::Rectangle& rRect ) override;
221  virtual SalFrame* GetParent() const override;
222  virtual void SetWindowState( const SalFrameState* pState ) override;
223  virtual bool GetWindowState( SalFrameState* pState ) override;
224  virtual void ShowFullScreen( bool bFullScreen, sal_Int32 nMonitor ) override;
225  virtual void StartPresentation( bool bStart ) override;
226  virtual void SetAlwaysOnTop( bool bOnTop ) override;
227  virtual void ToTop( SalFrameToTop nFlags ) override;
228  virtual void SetPointer( PointerStyle ePointerStyle ) override;
229  virtual void CaptureMouse( bool bMouse ) override;
230  virtual void SetPointerPos( tools::Long nX, tools::Long nY ) override;
231  using SalFrame::Flush;
232  virtual void Flush() override;
233  virtual void SetInputContext( SalInputContext* pContext ) override;
234  virtual void EndExtTextInput( EndExtTextInputFlags nFlags ) override;
235  virtual OUString GetKeyName( sal_uInt16 nKeyCode ) override;
236  virtual bool MapUnicodeToKeyCode( sal_Unicode aUnicode, LanguageType aLangType, vcl::KeyCode& rKeyCode ) override;
237  virtual LanguageType GetInputLanguage() override;
238  virtual void UpdateSettings( AllSettings& rSettings ) override;
239  virtual void Beep() override;
240  virtual const SystemEnvData* GetSystemData() const override;
241  virtual SalPointerState GetPointerState() override;
242  virtual KeyIndicatorState GetIndicatorState() override;
243  virtual void SimulateKeyPress( sal_uInt16 nKeyCode ) override;
244  virtual void SetParent( SalFrame* pNewParent ) override;
245  virtual bool SetPluginParent( SystemParentData* pNewParent ) override;
246 
247  virtual void SetScreenNumber( unsigned int ) override;
248  virtual void SetApplicationID( const OUString &rWMClass ) override;
249 
250  // shaped system windows
251  // set clip region to none (-> rectangular windows, normal state)
252  virtual void ResetClipRegion() override;
253  // start setting the clipregion consisting of nRects rectangles
254  virtual void BeginSetClipRegion( sal_uInt32 nRects ) override;
255  // add a rectangle to the clip region
256  virtual void UnionClipRegion( tools::Long nX, tools::Long nY, tools::Long nWidth, tools::Long nHeight ) override;
257  // done setting up the clipregion
258  virtual void EndSetClipRegion() override;
259 
261  void setPendingSizeEvent();
262 };
263 
264 #endif // INCLUDED_VCL_INC_UNX_SALFRAME_H
265 
266 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
bool CallCallback(SalEvent nEvent, const void *pEvent) const
Definition: salframe.hxx:305
virtual void SetPointer(PointerStyle ePointerStyle) override
SalI18N_InputContext * getInputContext() const
Definition: unx/salframe.h:193
SystemEnvData maSystemChildData
Definition: unx/salframe.h:122
bool bViewable_
Definition: unx/salframe.h:96
bool HandleReparentEvent(XReparentEvent *pEvent)
virtual void Beep() override
::Window mhForeignParent
Definition: unx/salframe.h:75
virtual SalFrame * GetParent() const override
bool HandleExposeEvent(XEvent const *pEvent)
virtual void SimulateKeyPress(sal_uInt16 nKeyCode) override
virtual SalPointerState GetPointerState() override
::Window GetWindow() const
Definition: unx/salframe.h:177
std::unique_ptr< X11SalGraphics > pFreeGraphics_
Definition: unx/salframe.h:84
void Minimize()
std::unique_ptr< SalI18N_InputContext > mpInputContext
Definition: unx/salframe.h:124
friend class vcl_sal::NetWMAdaptor
Definition: unx/salframe.h:63
virtual void GetClientSize(tools::Long &rWidth, tools::Long &rHeight) override
long Long
X11SalFrame * mpParent
Definition: unx/salframe.h:66
bool m_bSetFocusOnMap
Definition: unx/salframe.h:102
virtual ~X11SalFrame() override
bool HandleMouseEvent(XEvent *pEvent)
tools::Rectangle maRestorePosSize
Definition: unx/salframe.h:92
ModKeyFlags
Definition: keycodes.hxx:163
virtual void SetInputContext(SalInputContext *pContext) override
bool mPendingSizeEvent
Definition: unx/salframe.h:129
bool mbSendExtKeyModChange
Definition: unx/salframe.h:86
virtual void EndSetClipRegion() override
virtual void SetMinClientSize(tools::Long nWidth, tools::Long nHeight) override
DECL_LINK(HandleAlwaysOnTopRaise, Timer *, void)
virtual void SetMenu(SalMenu *pMenu) override
bool mbMaximizedVert
Definition: unx/salframe.h:111
virtual void ToTop(SalFrameToTop nFlags) override
bool m_bXEmbed
Definition: unx/salframe.h:99
virtual void BeginSetClipRegion(sal_uInt32 nRects) override
void setPendingSizeEvent()
SalX11Screen m_nXScreen
Definition: unx/salframe.h:72
virtual void SetPointerPos(tools::Long nX, tools::Long nY) override
::Window GetStackingWindow() const
Definition: unx/salframe.h:180
sal_uInt16 sal_Unicode
const SalX11Screen & GetScreenNumber() const
Definition: unx/salframe.h:176
virtual void StartPresentation(bool bStart) override
void Restore()
ScreenSaverInhibitor maScreenSaverInhibitor
Definition: unx/salframe.h:104
bool mbMaximizedHorz
Definition: unx/salframe.h:112
void Maximize()
::Window mhStackingWindow
Definition: unx/salframe.h:77
void updateScreenNumber()
sal_uInt64 SalExtStyle
Definition: salframe.hxx:95
virtual void ReleaseGraphics(SalGraphics *pGraphics) override
virtual const SystemEnvData * GetSystemData() const override
virtual void SetIcon(sal_uInt16 nIcon) override
virtual void ResetClipRegion() override
SalFrameStyleFlags nStyle_
Definition: unx/salframe.h:93
SalDisplay * GetDisplay() const
Definition: unx/salframe.h:168
virtual void SetWindowState(const SalFrameState *pState) override
virtual void SetApplicationID(const OUString &rWMClass) override
bool HandleStateEvent(XPropertyEvent const *pEvent)
std::list< X11SalFrame * > maChildren
Definition: unx/salframe.h:69
void HandleExtTextEvent(XClientMessageEvent const *pEvent)
SalFrameToTop
Definition: salframe.hxx:43
void askForXEmbedFocus(sal_Int32 i_nTimeCode)
SalExtStyle mnExtStyle
Definition: unx/salframe.h:94
Display * GetDisplay() const
Definition: saldisp.hxx:359
virtual SalGraphics * AcquireGraphics() override
WMWindowType
Definition: unx/salframe.h:50
virtual bool MapUnicodeToKeyCode(sal_Unicode aUnicode, LanguageType aLangType, vcl::KeyCode &rKeyCode) override
bool HandleFocusEvent(XFocusChangeEvent const *pEvent)
virtual void SetMaxClientSize(tools::Long nWidth, tools::Long nHeight) override
bool HandleKeyEvent(XKeyEvent *pEvent)
bool IsChildWindow() const
Definition: unx/salframe.h:190
virtual void Flush() override
virtual bool GetWindowState(SalFrameState *pState) override
WMWindowType meWindowType
Definition: unx/salframe.h:110
void Center()
bool HandleSizeEvent(XConfigureEvent *pEvent)
virtual void UnionClipRegion(tools::Long nX, tools::Long nY, tools::Long nWidth, tools::Long nHeight) override
KeyIndicatorState
Definition: keycodes.hxx:184
Bool mbInputFocus
Definition: unx/salframe.h:125
::Window GetForeignParent() const
Definition: unx/salframe.h:179
virtual LanguageType GetInputLanguage() override
Cursor GetCursor() const
Definition: unx/salframe.h:184
virtual void CaptureMouse(bool bMouse) override
virtual void SetTitle(const OUString &rTitle) override
virtual void updateGraphics(bool bClear)
EndExtTextInputFlags
Definition: window.hxx:372
Display
virtual void UpdateSettings(AllSettings &rSettings) override
void Init(SalFrameStyleFlags nSalFrameStyle, SalX11Screen nScreen, SystemParentData const *pParentData, bool bUseGeometry=false)
::Window mhWindow
Definition: unx/salframe.h:73
tools::Rectangle maPaintRegion
Definition: unx/salframe.h:105
void createNewWindow(::Window aParent, SalX11Screen nXScreen=SalX11Screen(-1))
virtual void Flush()=0
void SetPosSize(const tools::Rectangle &rPosSize)
ModKeyFlags mnExtKeyMod
Definition: unx/salframe.h:87
virtual KeyIndicatorState GetIndicatorState() override
void Close() const
Definition: unx/salframe.h:181
::Window mhShellWindow
Definition: unx/salframe.h:74
Timer maAlwaysOnTopRaiseTimer
Definition: unx/salframe.h:107
A SalFrame is a system window (e.g. an X11 window).
Definition: salframe.hxx:112
virtual void SetScreenNumber(unsigned int) override
void GetPosSize(tools::Rectangle &rPosSize)
Cursor hCursor_
Definition: unx/salframe.h:80
virtual void SetExtendedFrameStyle(SalExtStyle nExtStyle) override
friend class vcl_sal::GnomeWMAdaptor
Definition: unx/salframe.h:64
bool IsFloatGrabWindow() const
SalDisplay * pDisplay_
Definition: unx/salframe.h:71
std::vector< XRectangle > m_vClipRectangles
Definition: unx/salframe.h:127
void RestackChildren()
Display * GetXDisplay() const
Definition: unx/salframe.h:172
SalFrameStyleFlags
Definition: salframe.hxx:64
SalFrameStyleFlags GetStyle() const
Definition: unx/salframe.h:182
virtual OUString GetKeyName(sal_uInt16 nKeyCode) override
bool Dispatch(XEvent *pEvent)
::Window GetShellWindow() const
Definition: unx/salframe.h:178
bool HandleClientMessage(XClientMessageEvent *pEvent)
bool appendUnicodeSequence(sal_Unicode)
void beginUnicodeSequence()
std::unique_ptr< X11SalGraphics > pGraphics_
Definition: unx/salframe.h:83
bool endUnicodeSequence()
PointerStyle
Definition: ptrstyle.hxx:25
OUString m_sWMClass
Definition: unx/salframe.h:120
virtual void ShowFullScreen(bool bFullScreen, sal_Int32 nMonitor) override
bool IsOverrideRedirect() const
bool IsSysChildWindow() const
Definition: unx/salframe.h:191
bool IsCaptured() const
Definition: unx/salframe.h:185
Definition: timer.hxx:26
virtual void DrawMenuBar() override
virtual bool SetPluginParent(SystemParentData *pNewParent) override
void setXEmbedInfo()
bool mbTransientForRoot
Definition: unx/salframe.h:68
virtual void SetParent(SalFrame *pNewParent) override
virtual void Show(bool bVisible, bool bNoActivate=false) override
X11SalFrame(SalFrame *pParent, SalFrameStyleFlags nSalFrameStyle, SystemParentData const *pSystemParent=nullptr)
virtual void EndExtTextInput(EndExtTextInputFlags nFlags) override
OUString m_aTitle
Definition: unx/salframe.h:118
bool hasFocus() const
Definition: unx/salframe.h:194
virtual bool PostEvent(std::unique_ptr< ImplSVEvent > pData) override
void SetSize(const Size &rSize)
bool bDefaultPosition_
Definition: unx/salframe.h:98
bool bAlwaysOnTop_
Definition: unx/salframe.h:95
virtual void SetAlwaysOnTop(bool bOnTop) override
bool mbFullScreen
Definition: unx/salframe.h:113
virtual void GetWorkArea(tools::Rectangle &rRect) override
void updateWMClass()