Logo ROOT  
Reference Guide
TGDNDManager.h
Go to the documentation of this file.
1// @(#)root/gui:$Id$
2// Author: Bertrand Bellenot 19/04/07
3
4/*************************************************************************
5 * Copyright (C) 1995-2021, Rene Brun and Fons Rademakers. *
6 * All rights reserved. *
7 * *
8 * For the licensing terms see $ROOTSYS/LICENSE. *
9 * For the list of contributors see $ROOTSYS/README/CREDITS. *
10 *************************************************************************/
11
12#ifndef ROOT_TGDNDManager
13#define ROOT_TGDNDManager
14
15#include "TGFrame.h"
16
17class TGMainFrame;
18class TGDragWindow;
19class TTimer;
20
21
22class TGDragWindow : public TGFrame {
23
24protected:
25 static Cursor_t fgDefaultCursor; // Default Cursor
26
27protected:
28 virtual void DoRedraw();
29
30 Window_t fInput; ///< Input Window
31 Pixmap_t fPic, fMask; ///< Pixmaps used as Window shape
32 UInt_t fPw, fPh; ///< Hot point coordinates (x and y)
33
34public:
35 TGDragWindow(const TGWindow *p, Pixmap_t pic, Pixmap_t mask,
36 UInt_t options = kChildFrame, Pixel_t back = GetWhitePixel());
37 virtual ~TGDragWindow();
38
39 virtual TGDimension GetDefaultSize() const { return TGDimension(fPw, fPh); }
40
41 virtual void MapWindow();
42 virtual void UnmapWindow();
43 virtual void RaiseWindow();
44 virtual void LowerWindow();
45 virtual void MapRaised();
46
47 virtual void Layout();
48
49 Window_t GetInputId() const { return fInput; }
50 Bool_t HasWindow(Window_t w) const { return (w == fId || w == fInput); }
51
52 ClassDef(TGDragWindow, 0) // Window used for dragging
53};
54
55
56/** \class TDNDData
57 \ingroup guiwidgets
58
59Drag and drop data container.
60
61*/
62
63
64class TDNDData : public TObject {
65private:
66 TDNDData(const TDNDData&) = delete;
67 TDNDData& operator=(const TDNDData&) = delete;
68
69public:
70 TDNDData(Atom_t dt = kNone, void *d = nullptr, Int_t len = 0, Atom_t act = kNone) :
71 fDataType(dt), fAction(act), fData(d), fDataLength(len) {}
73
74 Atom_t fDataType; ///< Data type description
75 Atom_t fAction; ///< Action description
76 void *fData; ///< Actual data
77 Int_t fDataLength; ///< Length of data
78
79 ClassDef(TDNDData, 0) // Drag and drop specific data
80};
81
82
83class TGDNDManager : public TObject {
84
85private:
86 TGDNDManager(const TGDNDManager&) = delete;
88
89protected:
90 TGFrame *fMain; ///< pointer on TGMainFrame
91 Atom_t fVersion; ///< not really an Atom, but a long
92 Atom_t *fTypelist, *fDraggerTypes; ///< lists of DND types
93 Atom_t fDropType; ///< drop type
94 Atom_t fAcceptedAction, fLocalAction; ///< accepted and local actions
95
96 Bool_t fDragging; ///< kTRUE while dragging
97 Bool_t fDropAccepted; ///< kTRUE if drop accepted
98 Bool_t fStatusPending; ///< kTRUE if status is pending
99 Bool_t fUseVersion; ///< kTRUE if DND version is used
100 Bool_t fProxyOurs; ///< kTRUE if root proxy is ours
101 Window_t fSource, fTarget; ///< source and target windows
102 Bool_t fTargetIsDNDAware; ///< kTRUE if target is DND aware
103 UInt_t fGrabEventMask; ///< pointer grab event mask
104 TGFrame *fLocalSource, *fLocalTarget; ///< local source and target
105
106 TTimer *fDropTimeout; ///< drop timeout
107 TGDragWindow *fDragWin; ///< drag window
108
109 Pixmap_t fPic, fMask; ///< pixmap used for the drag window
110 Int_t fHotx, fHoty; ///< hot point coordinates
111 Cursor_t fDNDNoDropCursor; ///< no drop cursor type
112
113protected:
122
125
126protected:
127 void InitAtoms();
130 Bool_t IsDNDAware(Window_t win, Atom_t *typelist = 0);
132
133 void SendDNDEnter(Window_t target);
134 void SendDNDLeave(Window_t target);
135 void SendDNDPosition(Window_t target, int x, int y,
136 Atom_t action, Time_t timestamp);
137 void SendDNDStatus(Window_t target, Atom_t action);
138 void SendDNDDrop(Window_t target);
139 void SendDNDFinished(Window_t src);
140
141 Bool_t HandleDNDEnter(Window_t src, long vers, Atom_t dataTypes[3]);
143 Bool_t HandleDNDPosition(Window_t src, int x_root, int y_root, Atom_t action, Time_t timestamp);
144 Bool_t HandleDNDStatus(Window_t from, int accepted,
145 Rectangle_t skip, Atom_t action);
146 Bool_t HandleDNDDrop(Window_t src, Time_t timestamp);
148
149public:
150 TGDNDManager(TGFrame *toplevel, Atom_t *typelist);
151 virtual ~TGDNDManager();
152
156
158
159 //--- called by widgets
160
161 TGFrame *GetMainFrame() const { return fMain; }
163 void SetDragPixmap(Pixmap_t pic, Pixmap_t mask, Int_t hot_x, Int_t hot_y);
166
167 Bool_t StartDrag(TGFrame *src, Int_t x_root, Int_t y_root,
168 Window_t grabWin = kNone);
169 Bool_t Drag(Int_t x_root, Int_t y_root, Atom_t action, Time_t timestamp);
170 Bool_t Drop();
171 Bool_t EndDrag();
172
173 Bool_t IsDragging() const { return fDragging; }
174 Window_t GetSource() const { return fSource; }
175 Window_t GetTarget() const { return fTarget; }
176 Atom_t *GetTypeList() const { return fTypelist; }
177
178 static Atom_t GetDNDAware();
179 static Atom_t GetDNDSelection();
180 static Atom_t GetDNDProxy();
181 static Atom_t GetDNDEnter();
182 static Atom_t GetDNDLeave();
183 static Atom_t GetDNDPosition();
184 static Atom_t GetDNDStatus();
185 static Atom_t GetDNDDrop();
186 static Atom_t GetDNDFinished();
187 static Atom_t GetDNDVersion();
188 static Atom_t GetDNDActionCopy();
189 static Atom_t GetDNDActionMove();
190 static Atom_t GetDNDActionLink();
191 static Atom_t GetDNDActionAsk();
193 static Atom_t GetDNDTypeList();
194 static Atom_t GetDNDActionList();
196 static Atom_t GetXCDNDData();
197
198 ClassDef(TGDNDManager, 0) // The main Drag and Drop Manager
199};
200
201R__EXTERN TGDNDManager *gDNDManager; // global drag and drop manager
202
203#endif // ROOT_TGDNDManager
204
int Int_t
Definition: CPyCppyy.h:43
unsigned int UInt_t
Definition: CPyCppyy.h:44
#define R__EXTERN
Definition: DllImport.h:27
Handle_t Cursor_t
Cursor handle.
Definition: GuiTypes.h:34
Handle_t Pixmap_t
Pixmap handle.
Definition: GuiTypes.h:30
ULong_t Time_t
Event time.
Definition: GuiTypes.h:42
@ kChildFrame
Definition: GuiTypes.h:379
Handle_t Atom_t
WM token.
Definition: GuiTypes.h:37
const Handle_t kNone
Definition: GuiTypes.h:88
ULong_t Pixel_t
Pixel value.
Definition: GuiTypes.h:40
Handle_t Window_t
Window handle.
Definition: GuiTypes.h:29
#define d(i)
Definition: RSha256.hxx:102
bool Bool_t
Definition: RtypesCore.h:63
#define ClassDef(name, id)
Definition: Rtypes.h:325
R__EXTERN TGDNDManager * gDNDManager
Definition: TGDNDManager.h:201
Drag and drop data container.
Definition: TGDNDManager.h:64
TDNDData(Atom_t dt=kNone, void *d=nullptr, Int_t len=0, Atom_t act=kNone)
Definition: TGDNDManager.h:70
Atom_t fDataType
Data type description.
Definition: TGDNDManager.h:74
TDNDData & operator=(const TDNDData &)=delete
Int_t fDataLength
Length of data.
Definition: TGDNDManager.h:77
void * fData
Actual data.
Definition: TGDNDManager.h:76
Atom_t fAction
Action description.
Definition: TGDNDManager.h:75
TDNDData(const TDNDData &)=delete
static Atom_t fgDNDAware
Definition: TGDNDManager.h:114
static Atom_t fgDNDVersion
Definition: TGDNDManager.h:117
Bool_t HandleDNDEnter(Window_t src, long vers, Atom_t dataTypes[3])
Handle DND enter event.
virtual ~TGDNDManager()
TGDNDManager destructor.
static Atom_t fgDNDActionPrivate
Definition: TGDNDManager.h:119
Window_t fSource
Definition: TGDNDManager.h:101
static Atom_t fgDNDActionAsk
Definition: TGDNDManager.h:119
static Atom_t GetDNDDrop()
static Atom_t GetDNDActionAsk()
TGFrame * fMain
pointer on TGMainFrame
Definition: TGDNDManager.h:90
static Atom_t fgDNDActionMove
Definition: TGDNDManager.h:118
Pixmap_t fMask
pixmap used for the drag window
Definition: TGDNDManager.h:109
Bool_t HandleSelectionRequest(Event_t *event)
Handle selection request event.
static Atom_t fgDNDActionLink
Definition: TGDNDManager.h:118
Int_t fHoty
hot point coordinates
Definition: TGDNDManager.h:110
Bool_t HandleClientMessage(Event_t *event)
Handle DND related client messages.
TTimer * fDropTimeout
drop timeout
Definition: TGDNDManager.h:106
static Atom_t fgDNDActionDescrip
Definition: TGDNDManager.h:120
void SendDNDEnter(Window_t target)
Send DND enter message to target window.
static Atom_t fgDNDSelection
Definition: TGDNDManager.h:114
Bool_t fTargetIsDNDAware
kTRUE if target is DND aware
Definition: TGDNDManager.h:102
Bool_t fStatusPending
kTRUE if status is pending
Definition: TGDNDManager.h:98
TGDNDManager(const TGDNDManager &)=delete
TGFrame * GetMainFrame() const
Definition: TGDNDManager.h:161
Window_t GetTarget() const
Definition: TGDNDManager.h:175
void InitAtoms()
Initialize drag and drop atoms.
static Atom_t fgDNDFinished
Definition: TGDNDManager.h:116
Atom_t fDropType
drop type
Definition: TGDNDManager.h:93
static Atom_t fgDNDDrop
Definition: TGDNDManager.h:116
static Atom_t GetXCDNDData()
static Atom_t GetDNDVersion()
Bool_t fProxyOurs
kTRUE if root proxy is ours
Definition: TGDNDManager.h:100
static Atom_t GetDNDActionLink()
static Atom_t fgDNDEnter
Definition: TGDNDManager.h:115
Bool_t HandleTimer(TTimer *t)
Handle Drop timeout.
Bool_t HandleDNDDrop(Window_t src, Time_t timestamp)
Handle DND drop event.
static Atom_t GetDNDStatus()
Atom_t * fDraggerTypes
lists of DND types
Definition: TGDNDManager.h:92
static Atom_t fgXCDNDData
Definition: TGDNDManager.h:121
Bool_t HandleDNDFinished(Window_t target)
Handle DND finished event.
static Atom_t fgDNDPosition
Definition: TGDNDManager.h:115
static Atom_t fgDNDLeave
Definition: TGDNDManager.h:115
Bool_t HandleSelection(Event_t *event)
Handle selection event.
Atom_t fLocalAction
accepted and local actions
Definition: TGDNDManager.h:94
Bool_t IsDragging() const
Definition: TGDNDManager.h:173
TGFrame * fLocalSource
Definition: TGDNDManager.h:104
static Atom_t GetDNDTypeList()
static Bool_t fgInit
Definition: TGDNDManager.h:123
Window_t GetSource() const
Definition: TGDNDManager.h:174
Window_t GetRootProxy()
Get root window proxy.
Bool_t HandleDNDStatus(Window_t from, int accepted, Rectangle_t skip, Atom_t action)
Handle DND status event.
void SetMainFrame(TGFrame *main)
Definition: TGDNDManager.h:162
static Atom_t fgDNDActionCopy
Definition: TGDNDManager.h:118
static Atom_t GetDNDProxy()
static Atom_t fgDNDProxy
Definition: TGDNDManager.h:114
static Atom_t GetDNDActionDescrip()
TGDNDManager & operator=(const TGDNDManager &)=delete
Bool_t StartDrag(TGFrame *src, Int_t x_root, Int_t y_root, Window_t grabWin=kNone)
Start dragging.
Bool_t fUseVersion
kTRUE if DND version is used
Definition: TGDNDManager.h:99
void SendDNDStatus(Window_t target, Atom_t action)
Send DND status message to source window.
Bool_t fDragging
kTRUE while dragging
Definition: TGDNDManager.h:96
static Atom_t GetDNDAware()
Bool_t IsDNDAware(Window_t win, Atom_t *typelist=0)
Check if window win is DND aware.
void SetDragPixmap(Pixmap_t pic, Pixmap_t mask, Int_t hot_x, Int_t hot_y)
Set drag window pixmaps and hotpoint.
Bool_t IsTopLevel(Window_t win)
static Atom_t GetDNDFinished()
static Atom_t GetDNDSelection()
static Atom_t fgDNDActionList
Definition: TGDNDManager.h:120
UInt_t fGrabEventMask
pointer grab event mask
Definition: TGDNDManager.h:103
Bool_t fDropAccepted
kTRUE if drop accepted
Definition: TGDNDManager.h:97
static Atom_t GetDNDActionList()
Window_t FindWindow(Window_t root, Int_t x, Int_t y, Int_t maxd)
Search for DND aware window at position x,y.
static Atom_t fgDNDTypeList
Definition: TGDNDManager.h:120
Atom_t fVersion
not really an Atom, but a long
Definition: TGDNDManager.h:91
Bool_t RemoveRootProxy()
Remove root window proxy.
static Atom_t GetDNDEnter()
Bool_t HandleDNDPosition(Window_t src, int x_root, int y_root, Atom_t action, Time_t timestamp)
Handle DND position event.
Atom_t * GetTypeList() const
Definition: TGDNDManager.h:176
static Atom_t fgXAWMState
Definition: TGDNDManager.h:124
Pixmap_t fPic
Definition: TGDNDManager.h:109
void SendDNDPosition(Window_t target, int x, int y, Atom_t action, Time_t timestamp)
Send DND position message to target window.
void SendDNDFinished(Window_t src)
Send DND finished message to source window.
Cursor_t fDNDNoDropCursor
no drop cursor type
Definition: TGDNDManager.h:111
Bool_t Drag(Int_t x_root, Int_t y_root, Atom_t action, Time_t timestamp)
Process drag event.
TGFrame * fLocalTarget
local source and target
Definition: TGDNDManager.h:104
void SendDNDDrop(Window_t target)
Send DND drop message to target window.
static Atom_t GetDNDPosition()
static Atom_t GetDNDActionPrivate()
static Atom_t fgDNDStatus
Definition: TGDNDManager.h:115
Window_t fTarget
source and target windows
Definition: TGDNDManager.h:101
Bool_t HandleDNDLeave(Window_t src)
Handle DND leave event.
Atom_t fAcceptedAction
Definition: TGDNDManager.h:94
void SendDNDLeave(Window_t target)
Send DND leave message to target window.
TGDragWindow * fDragWin
drag window
Definition: TGDNDManager.h:107
Atom_t * fTypelist
Definition: TGDNDManager.h:92
Bool_t Drop()
Drop.
Bool_t SetRootProxy()
Set root window proxy.
static Atom_t GetDNDActionCopy()
Bool_t EndDrag()
End dragging.
static Atom_t GetDNDActionMove()
static Atom_t GetDNDLeave()
Window used as drag icon during drag and drop operations.
Definition: TGDNDManager.h:22
virtual ~TGDragWindow()
TGDragWindow destructor.
virtual void DoRedraw()
Redraw TGDragWindow.
virtual void MapRaised()
Map and Raise TGDragWindow.
virtual void Layout()
Layout TGDragWindow.
virtual void RaiseWindow()
Raise TGDragWindow.
virtual void UnmapWindow()
Unmap TGDragWindow.
Bool_t HasWindow(Window_t w) const
Definition: TGDNDManager.h:50
virtual TGDimension GetDefaultSize() const
std::cout << fWidth << "x" << fHeight << std::endl;
Definition: TGDNDManager.h:39
TGDragWindow(const TGWindow *p, Pixmap_t pic, Pixmap_t mask, UInt_t options=kChildFrame, Pixel_t back=GetWhitePixel())
TGDragWindow constructor.
Window_t GetInputId() const
Definition: TGDNDManager.h:49
virtual void LowerWindow()
Lower TGDragWindow.
Window_t fInput
Input Window.
Definition: TGDNDManager.h:30
Pixmap_t fMask
Pixmaps used as Window shape.
Definition: TGDNDManager.h:31
Pixmap_t fPic
Definition: TGDNDManager.h:31
UInt_t fPh
Hot point coordinates (x and y)
Definition: TGDNDManager.h:32
static Cursor_t fgDefaultCursor
Definition: TGDNDManager.h:25
virtual void MapWindow()
Map TGDragWindow.
A subclasses of TGWindow, and is used as base class for some simple widgets (buttons,...
Definition: TGFrame.h:80
static Pixel_t GetWhitePixel()
Get white pixel value.
Definition: TGFrame.cxx:709
Defines top level windows that interact with the system Window Manager.
Definition: TGFrame.h:398
Handle_t fId
X11/Win32 Window identifier.
Definition: TGObject.h:26
ROOT GUI Window base class.
Definition: TGWindow.h:23
Mother of all ROOT objects.
Definition: TObject.h:37
Handles synchronous and a-synchronous timer events.
Definition: TTimer.h:51
int main()
Double_t y[n]
Definition: legend1.C:17
Double_t x[n]
Definition: legend1.C:17
Event structure.
Definition: GuiTypes.h:174
Rectangle structure (maps to the X11 XRectangle structure)
Definition: GuiTypes.h:361