X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gdk%2Fgdkselection.h;h=ae964e78f5d47b125b699646cf37d1b257c24334;hb=1db87c897f930171646351c99af7df09dc7ec949;hp=2013e283014d5831612b1873bd27ef60d82c3bc7;hpb=b1165617b79f589695172db638bd101c44c74ea6;p=~andy%2Fgtk diff --git a/gdk/gdkselection.h b/gdk/gdkselection.h index 2013e2830..ae964e78f 100644 --- a/gdk/gdkselection.h +++ b/gdk/gdkselection.h @@ -1,39 +1,152 @@ +/* GDK - The GIMP Drawing Kit + * 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, see . + */ + +/* + * 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 + * GTK+ at ftp://ftp.gtk.org/pub/gtk/. + */ + #ifndef __GDK_SELECTION_H__ #define __GDK_SELECTION_H__ +#if !defined (__GDK_H_INSIDE__) && !defined (GDK_COMPILATION) +#error "Only can be included directly." +#endif + #include -#ifdef __cplusplus -extern "C" { -#endif /* __cplusplus */ +G_BEGIN_DECLS /* Predefined atoms relating to selections. In general, one will need to use * gdk_intern_atom */ +/** + * GDK_SELECTION_PRIMARY: + * + * A #GdkAtom representing the PRIMARY selection. + */ #define GDK_SELECTION_PRIMARY _GDK_MAKE_ATOM (1) + +/** + * GDK_SELECTION_SECONDARY: + * + * A #GdkAtom representing the SECONDARY selection. + */ #define GDK_SELECTION_SECONDARY _GDK_MAKE_ATOM (2) + +/** + * GDK_SELECTION_CLIPBOARD: + * + * A #GdkAtom representing the CLIPBOARD selection. + */ #define GDK_SELECTION_CLIPBOARD _GDK_MAKE_ATOM (69) + +/** + * GDK_TARGET_BITMAP: + * + * A #GdkAtom representing the BITMAP selection target. + */ #define GDK_TARGET_BITMAP _GDK_MAKE_ATOM (5) + +/** + * GDK_TARGET_COLORMAP: + * + * A #GdkAtom representing the COLORMAP selection target. + */ #define GDK_TARGET_COLORMAP _GDK_MAKE_ATOM (7) + +/** + * GDK_TARGET_DRAWABLE: + * + * A #GdkAtom representing the DRAWABLE selection target. + */ #define GDK_TARGET_DRAWABLE _GDK_MAKE_ATOM (17) + +/** + * GDK_TARGET_PIXMAP: + * + * A #GdkAtom representing the PIXMAP selection target. + */ #define GDK_TARGET_PIXMAP _GDK_MAKE_ATOM (20) + +/** + * GDK_TARGET_STRING: + * + * A #GdkAtom representing the STRING selection target. + */ #define GDK_TARGET_STRING _GDK_MAKE_ATOM (31) + +/** + * GDK_SELECTION_TYPE_ATOM: + * + * A #GdkAtom representing the ATOM selection type. + */ #define GDK_SELECTION_TYPE_ATOM _GDK_MAKE_ATOM (4) + +/** + * GDK_SELECTION_TYPE_BITMAP: + * + * A #GdkAtom representing the BITMAP selection type. + */ #define GDK_SELECTION_TYPE_BITMAP _GDK_MAKE_ATOM (5) + +/** + * GDK_SELECTION_TYPE_COLORMAP: + * + * A #GdkAtom representing the COLORMAP selection type. + */ #define GDK_SELECTION_TYPE_COLORMAP _GDK_MAKE_ATOM (7) + +/** + * GDK_SELECTION_TYPE_DRAWABLE: + * + * A #GdkAtom representing the DRAWABLE selection type. + */ #define GDK_SELECTION_TYPE_DRAWABLE _GDK_MAKE_ATOM (17) + +/** + * GDK_SELECTION_TYPE_INTEGER: + * + * A #GdkAtom representing the INTEGER selection type. + */ #define GDK_SELECTION_TYPE_INTEGER _GDK_MAKE_ATOM (19) -#define GDK_SELECTION_TYPE_PIXMAP _GDK_MAKE_ATOM (20) -#define GDK_SELECTION_TYPE_WINDOW _GDK_MAKE_ATOM (33) -#define GDK_SELECTION_TYPE_STRING _GDK_MAKE_ATOM (31) -#ifndef GDK_DISABLE_DEPRECATED +/** + * GDK_SELECTION_TYPE_PIXMAP: + * + * A #GdkAtom representing the PIXMAP selection type. + */ +#define GDK_SELECTION_TYPE_PIXMAP _GDK_MAKE_ATOM (20) -typedef GdkAtom GdkSelection; -typedef GdkAtom GdkTarget; -typedef GdkAtom GdkSelectionType; +/** + * GDK_SELECTION_TYPE_WINDOW: + * + * A #GdkAtom representing the WINDOW selection type. + */ +#define GDK_SELECTION_TYPE_WINDOW _GDK_MAKE_ATOM (33) -#endif /* GDK_DISABLE_DEPRECATED */ +/** + * GDK_SELECTION_TYPE_STRING: + * + * A #GdkAtom representing the STRING selection type. + */ +#define GDK_SELECTION_TYPE_STRING _GDK_MAKE_ATOM (31) /* Selections */ @@ -54,32 +167,42 @@ gboolean gdk_selection_owner_set_for_display (GdkDisplay *display, GdkWindow *gdk_selection_owner_get_for_display (GdkDisplay *display, GdkAtom selection); +/** + * 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. + */ void gdk_selection_convert (GdkWindow *requestor, GdkAtom selection, GdkAtom target, guint32 time_); -gboolean gdk_selection_property_get (GdkWindow *requestor, +gint gdk_selection_property_get (GdkWindow *requestor, guchar **data, GdkAtom *prop_type, gint *prop_format); -#ifndef GDK_MULTIHEAD_SAFE -void gdk_selection_send_notify (guint32 requestor, - GdkAtom selection, - GdkAtom target, - GdkAtom property, - guint32 time_); -#endif /* GDK_MULTIHEAD_SAFE */ - -void gdk_selection_send_notify_for_display (GdkDisplay *display, - guint32 requestor, - GdkAtom selection, - GdkAtom target, - GdkAtom property, - guint32 time_); - -#ifdef __cplusplus -} -#endif /* __cplusplus */ +void gdk_selection_send_notify (GdkWindow *requestor, + GdkAtom selection, + GdkAtom target, + GdkAtom property, + guint32 time_); + +void gdk_selection_send_notify_for_display (GdkDisplay *display, + GdkWindow *requestor, + GdkAtom selection, + GdkAtom target, + GdkAtom property, + guint32 time_); + +G_END_DECLS #endif /* __GDK_SELECTION_H__ */