gdkselection.h 5.85 KB
Newer Older
Cody Russell's avatar
Cody Russell committed
1
/* GDK - The GIMP Drawing Kit
2
3
4
5
6
7
8
9
10
11
12
13
14
 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
Javier Jardón's avatar
Javier Jardón committed
15
 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
16
17
18
19
20
21
 */

/*
 * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
 * file for a list of people on the GTK+ Team.  See the ChangeLog
 * files for a list of changes.  These files are distributed with
22
 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
23
24
 */

25
26
27
#ifndef __GDK_SELECTION_H__
#define __GDK_SELECTION_H__

28
#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION)
29
30
31
#error "Only <gdk/gdk.h> can be included directly."
#endif

Owen Taylor's avatar
Started  
Owen Taylor committed
32
#include <gdk/gdktypes.h>
33
#include <gdk/gdkversionmacros.h>
Owen Taylor's avatar
Started  
Owen Taylor committed
34

35
G_BEGIN_DECLS
Owen Taylor's avatar
Started  
Owen Taylor committed
36

37
38
39
/* Predefined atoms relating to selections. In general, one will need to use
 * gdk_intern_atom
 */
40
41
42
43
44
/**
 * GDK_SELECTION_PRIMARY:
 *
 * A #GdkAtom representing the <literal>PRIMARY</literal> selection.
 */
45
#define GDK_SELECTION_PRIMARY 		_GDK_MAKE_ATOM (1)
46
47
48
49
50
51

/**
 * GDK_SELECTION_SECONDARY:
 *
 * A #GdkAtom representing the <literal>SECONDARY</literal> selection.
 */
52
#define GDK_SELECTION_SECONDARY 	_GDK_MAKE_ATOM (2)
53
54
55
56
57
58

/**
 * GDK_SELECTION_CLIPBOARD:
 *
 * A #GdkAtom representing the <literal>CLIPBOARD</literal> selection.
 */
59
#define GDK_SELECTION_CLIPBOARD 	_GDK_MAKE_ATOM (69)
60
61
62
63
64
65

/**
 * GDK_TARGET_BITMAP:
 *
 * A #GdkAtom representing the <literal>BITMAP</literal> selection target.
 */
66
#define GDK_TARGET_BITMAP 		_GDK_MAKE_ATOM (5)
67
68
69
70
71
72

/**
 * GDK_TARGET_COLORMAP:
 *
 * A #GdkAtom representing the <literal>COLORMAP</literal> selection target.
 */
73
#define GDK_TARGET_COLORMAP 		_GDK_MAKE_ATOM (7)
74
75
76
77
78
79

/**
 * GDK_TARGET_DRAWABLE:
 *
 * A #GdkAtom representing the <literal>DRAWABLE</literal> selection target.
 */
80
#define GDK_TARGET_DRAWABLE 		_GDK_MAKE_ATOM (17)
81
82
83
84
85
86

/**
 * GDK_TARGET_PIXMAP:
 *
 * A #GdkAtom representing the <literal>PIXMAP</literal> selection target.
 */
87
#define GDK_TARGET_PIXMAP 		_GDK_MAKE_ATOM (20)
88
89
90
91
92
93

/**
 * GDK_TARGET_STRING:
 *
 * A #GdkAtom representing the <literal>STRING</literal> selection target.
 */
94
#define GDK_TARGET_STRING 		_GDK_MAKE_ATOM (31)
95
96
97
98
99
100

/**
 * GDK_SELECTION_TYPE_ATOM:
 *
 * A #GdkAtom representing the <literal>ATOM</literal> selection type.
 */
101
#define GDK_SELECTION_TYPE_ATOM 	_GDK_MAKE_ATOM (4)
102
103
104
105
106
107

/**
 * GDK_SELECTION_TYPE_BITMAP:
 *
 * A #GdkAtom representing the <literal>BITMAP</literal> selection type.
 */
108
#define GDK_SELECTION_TYPE_BITMAP 	_GDK_MAKE_ATOM (5)
109
110
111
112
113
114

/**
 * GDK_SELECTION_TYPE_COLORMAP:
 *
 * A #GdkAtom representing the <literal>COLORMAP</literal> selection type.
 */
115
#define GDK_SELECTION_TYPE_COLORMAP 	_GDK_MAKE_ATOM (7)
116
117
118
119
120
121

/**
 * GDK_SELECTION_TYPE_DRAWABLE:
 *
 * A #GdkAtom representing the <literal>DRAWABLE</literal> selection type.
 */
122
#define GDK_SELECTION_TYPE_DRAWABLE 	_GDK_MAKE_ATOM (17)
123
124
125
126
127
128

/**
 * GDK_SELECTION_TYPE_INTEGER:
 *
 * A #GdkAtom representing the <literal>INTEGER</literal> selection type.
 */
129
#define GDK_SELECTION_TYPE_INTEGER 	_GDK_MAKE_ATOM (19)
130
131
132
133
134
135

/**
 * GDK_SELECTION_TYPE_PIXMAP:
 *
 * A #GdkAtom representing the <literal>PIXMAP</literal> selection type.
 */
136
#define GDK_SELECTION_TYPE_PIXMAP 	_GDK_MAKE_ATOM (20)
137
138
139
140
141
142

/**
 * GDK_SELECTION_TYPE_WINDOW:
 *
 * A #GdkAtom representing the <literal>WINDOW</literal> selection type.
 */
143
#define GDK_SELECTION_TYPE_WINDOW 	_GDK_MAKE_ATOM (33)
144
145
146
147
148
149

/**
 * GDK_SELECTION_TYPE_STRING:
 *
 * A #GdkAtom representing the <literal>STRING</literal> selection type.
 */
150
#define GDK_SELECTION_TYPE_STRING 	_GDK_MAKE_ATOM (31)
151

Owen Taylor's avatar
Started  
Owen Taylor committed
152
153
/* Selections
 */
154
155

#ifndef GDK_MULTIHEAD_SAFE
156
GDK_AVAILABLE_IN_ALL
Owen Taylor's avatar
Started  
Owen Taylor committed
157
158
gboolean   gdk_selection_owner_set (GdkWindow	 *owner,
				    GdkAtom	  selection,
159
				    guint32	  time_,
Owen Taylor's avatar
Owen Taylor committed
160
				    gboolean      send_event);
161
GDK_AVAILABLE_IN_ALL
Owen Taylor's avatar
Started  
Owen Taylor committed
162
GdkWindow* gdk_selection_owner_get (GdkAtom	  selection);
163
164
#endif/* GDK_MULTIHEAD_SAFE */

165
GDK_AVAILABLE_IN_ALL
166
167
168
gboolean   gdk_selection_owner_set_for_display (GdkDisplay *display,
						GdkWindow  *owner,
						GdkAtom     selection,
169
						guint32     time_,
170
						gboolean    send_event);
171
GDK_AVAILABLE_IN_ALL
172
173
174
GdkWindow *gdk_selection_owner_get_for_display (GdkDisplay *display,
						GdkAtom     selection);

175
176
177
178
179
180
181
182
183
184
185
186
187
188
/**
 * gdk_selection_convert:
 * @requestor: a #GdkWindow.
 * @selection: an atom identifying the selection to get the
 *   contents of.
 * @target: the form in which to retrieve the selection.
 * @time_: the timestamp to use when retrieving the
 *   selection. The selection owner may refuse the
 *   request if it did not own the selection at
 *   the time indicated by the timestamp.
 *
 * Retrieves the contents of a selection in a given
 * form.
 */
189
GDK_AVAILABLE_IN_ALL
Owen Taylor's avatar
Started  
Owen Taylor committed
190
191
192
void	   gdk_selection_convert   (GdkWindow	 *requestor,
				    GdkAtom	  selection,
				    GdkAtom	  target,
193
				    guint32	  time_);
194
GDK_AVAILABLE_IN_ALL
195
gint       gdk_selection_property_get (GdkWindow  *requestor,
Owen Taylor's avatar
Started  
Owen Taylor committed
196
197
198
				       guchar	 **data,
				       GdkAtom	  *prop_type,
				       gint	  *prop_format);
199

200
GDK_AVAILABLE_IN_ALL
201
void	   gdk_selection_send_notify (GdkWindow      *requestor,
202
203
204
205
				      GdkAtom	      selection,
				      GdkAtom	      target,
				      GdkAtom	      property,
				      guint32	      time_);
206

207
GDK_AVAILABLE_IN_ALL
208
void       gdk_selection_send_notify_for_display (GdkDisplay      *display,
209
						  GdkWindow       *requestor,
210
211
212
213
						  GdkAtom     	   selection,
						  GdkAtom     	   target,
						  GdkAtom     	   property,
						  guint32     	   time_);
Owen Taylor's avatar
Started  
Owen Taylor committed
214

215
G_END_DECLS
Owen Taylor's avatar
Started  
Owen Taylor committed
216
217

#endif /* __GDK_SELECTION_H__ */