gtk/gdk/gdkselection.h
Matthias Clasen ca81028901 Add GDK_AVAILABLE_IN_ALL annotations in gdk
This is in preparation to modernizing our handing
of exported symbols.
2013-05-05 15:38:46 -04:00

218 lines
5.9 KiB
C

/* 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 <http://www.gnu.org/licenses/>.
*/
/*
* 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 <gdk/gdk.h> can be included directly."
#endif
#include <gdk/gdktypes.h>
#include <gdk/gdkversionmacros.h>
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 <literal>PRIMARY</literal> selection.
*/
#define GDK_SELECTION_PRIMARY _GDK_MAKE_ATOM (1)
/**
* GDK_SELECTION_SECONDARY:
*
* A #GdkAtom representing the <literal>SECONDARY</literal> selection.
*/
#define GDK_SELECTION_SECONDARY _GDK_MAKE_ATOM (2)
/**
* GDK_SELECTION_CLIPBOARD:
*
* A #GdkAtom representing the <literal>CLIPBOARD</literal> selection.
*/
#define GDK_SELECTION_CLIPBOARD _GDK_MAKE_ATOM (69)
/**
* GDK_TARGET_BITMAP:
*
* A #GdkAtom representing the <literal>BITMAP</literal> selection target.
*/
#define GDK_TARGET_BITMAP _GDK_MAKE_ATOM (5)
/**
* GDK_TARGET_COLORMAP:
*
* A #GdkAtom representing the <literal>COLORMAP</literal> selection target.
*/
#define GDK_TARGET_COLORMAP _GDK_MAKE_ATOM (7)
/**
* GDK_TARGET_DRAWABLE:
*
* A #GdkAtom representing the <literal>DRAWABLE</literal> selection target.
*/
#define GDK_TARGET_DRAWABLE _GDK_MAKE_ATOM (17)
/**
* GDK_TARGET_PIXMAP:
*
* A #GdkAtom representing the <literal>PIXMAP</literal> selection target.
*/
#define GDK_TARGET_PIXMAP _GDK_MAKE_ATOM (20)
/**
* GDK_TARGET_STRING:
*
* A #GdkAtom representing the <literal>STRING</literal> selection target.
*/
#define GDK_TARGET_STRING _GDK_MAKE_ATOM (31)
/**
* GDK_SELECTION_TYPE_ATOM:
*
* A #GdkAtom representing the <literal>ATOM</literal> selection type.
*/
#define GDK_SELECTION_TYPE_ATOM _GDK_MAKE_ATOM (4)
/**
* GDK_SELECTION_TYPE_BITMAP:
*
* A #GdkAtom representing the <literal>BITMAP</literal> selection type.
*/
#define GDK_SELECTION_TYPE_BITMAP _GDK_MAKE_ATOM (5)
/**
* GDK_SELECTION_TYPE_COLORMAP:
*
* A #GdkAtom representing the <literal>COLORMAP</literal> selection type.
*/
#define GDK_SELECTION_TYPE_COLORMAP _GDK_MAKE_ATOM (7)
/**
* GDK_SELECTION_TYPE_DRAWABLE:
*
* A #GdkAtom representing the <literal>DRAWABLE</literal> selection type.
*/
#define GDK_SELECTION_TYPE_DRAWABLE _GDK_MAKE_ATOM (17)
/**
* GDK_SELECTION_TYPE_INTEGER:
*
* A #GdkAtom representing the <literal>INTEGER</literal> selection type.
*/
#define GDK_SELECTION_TYPE_INTEGER _GDK_MAKE_ATOM (19)
/**
* GDK_SELECTION_TYPE_PIXMAP:
*
* A #GdkAtom representing the <literal>PIXMAP</literal> selection type.
*/
#define GDK_SELECTION_TYPE_PIXMAP _GDK_MAKE_ATOM (20)
/**
* GDK_SELECTION_TYPE_WINDOW:
*
* A #GdkAtom representing the <literal>WINDOW</literal> selection type.
*/
#define GDK_SELECTION_TYPE_WINDOW _GDK_MAKE_ATOM (33)
/**
* GDK_SELECTION_TYPE_STRING:
*
* A #GdkAtom representing the <literal>STRING</literal> selection type.
*/
#define GDK_SELECTION_TYPE_STRING _GDK_MAKE_ATOM (31)
/* Selections
*/
#ifndef GDK_MULTIHEAD_SAFE
GDK_AVAILABLE_IN_ALL
gboolean gdk_selection_owner_set (GdkWindow *owner,
GdkAtom selection,
guint32 time_,
gboolean send_event);
GDK_AVAILABLE_IN_ALL
GdkWindow* gdk_selection_owner_get (GdkAtom selection);
#endif/* GDK_MULTIHEAD_SAFE */
GDK_AVAILABLE_IN_ALL
gboolean gdk_selection_owner_set_for_display (GdkDisplay *display,
GdkWindow *owner,
GdkAtom selection,
guint32 time_,
gboolean send_event);
GDK_AVAILABLE_IN_ALL
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.
*/
GDK_AVAILABLE_IN_ALL
void gdk_selection_convert (GdkWindow *requestor,
GdkAtom selection,
GdkAtom target,
guint32 time_);
GDK_AVAILABLE_IN_ALL
gint gdk_selection_property_get (GdkWindow *requestor,
guchar **data,
GdkAtom *prop_type,
gint *prop_format);
GDK_AVAILABLE_IN_ALL
void gdk_selection_send_notify (GdkWindow *requestor,
GdkAtom selection,
GdkAtom target,
GdkAtom property,
guint32 time_);
GDK_AVAILABLE_IN_ALL
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__ */