gdkselection.h 5.72 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
15
16
17
18
19
20
21
22
23
 * 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
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

/*
 * 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
24
 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
25
26
 */

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

Owen Taylor's avatar
Started  
Owen Taylor committed
31
32
33
34
35
#ifndef __GDK_SELECTION_H__
#define __GDK_SELECTION_H__

#include <gdk/gdktypes.h>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

#ifndef GDK_MULTIHEAD_SAFE
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);
Owen Taylor's avatar
Started  
Owen Taylor committed
161
GdkWindow* gdk_selection_owner_get (GdkAtom	  selection);
162
163
164
165
166
#endif/* GDK_MULTIHEAD_SAFE */

gboolean   gdk_selection_owner_set_for_display (GdkDisplay *display,
						GdkWindow  *owner,
						GdkAtom     selection,
167
						guint32     time_,
168
169
170
171
						gboolean    send_event);
GdkWindow *gdk_selection_owner_get_for_display (GdkDisplay *display,
						GdkAtom     selection);

172
173
174
175
176
177
178
179
180
181
182
183
184
185
/**
 * 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.
 */
Owen Taylor's avatar
Started  
Owen Taylor committed
186
187
188
void	   gdk_selection_convert   (GdkWindow	 *requestor,
				    GdkAtom	  selection,
				    GdkAtom	  target,
189
				    guint32	  time_);
190
gint       gdk_selection_property_get (GdkWindow  *requestor,
Owen Taylor's avatar
Started  
Owen Taylor committed
191
192
193
				       guchar	 **data,
				       GdkAtom	  *prop_type,
				       gint	  *prop_format);
194

195
void	   gdk_selection_send_notify (GdkWindow      *requestor,
196
197
198
199
				      GdkAtom	      selection,
				      GdkAtom	      target,
				      GdkAtom	      property,
				      guint32	      time_);
200

201
void       gdk_selection_send_notify_for_display (GdkDisplay      *display,
202
						  GdkWindow       *requestor,
203
204
205
206
						  GdkAtom     	   selection,
						  GdkAtom     	   target,
						  GdkAtom     	   property,
						  guint32     	   time_);
Owen Taylor's avatar
Started  
Owen Taylor committed
207

208
G_END_DECLS
Owen Taylor's avatar
Started  
Owen Taylor committed
209
210

#endif /* __GDK_SELECTION_H__ */