|
- /* GTK - The GIMP Toolkit
- * Copyright (C) 2000 Red Hat, Inc.
- *
- * 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.
- *
- * Global clipboard abstraction.
- */
-
- #if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
- #error "Only <gtk/gtk.h> can be included directly."
- #endif
-
- #ifndef __GTK_CLIPBOARD_H__
- #define __GTK_CLIPBOARD_H__
-
- #include <gtk/gtkselection.h>
-
- G_BEGIN_DECLS
-
- #define GTK_TYPE_CLIPBOARD (gtk_clipboard_get_type ())
- #define GTK_CLIPBOARD(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_CLIPBOARD, GtkClipboard))
- #define GTK_IS_CLIPBOARD(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_CLIPBOARD))
-
- typedef void (* GtkClipboardReceivedFunc) (GtkClipboard *clipboard,
- GtkSelectionData *selection_data,
- gpointer data);
- typedef void (* GtkClipboardTextReceivedFunc) (GtkClipboard *clipboard,
- const gchar *text,
- gpointer data);
- typedef void (* GtkClipboardRichTextReceivedFunc) (GtkClipboard *clipboard,
- GdkAtom format,
- const guint8 *text,
- gsize length,
- gpointer data);
- typedef void (* GtkClipboardImageReceivedFunc) (GtkClipboard *clipboard,
- GdkPixbuf *pixbuf,
- gpointer data);
- typedef void (* GtkClipboardURIReceivedFunc) (GtkClipboard *clipboard,
- gchar **uris,
- gpointer data);
- typedef void (* GtkClipboardTargetsReceivedFunc) (GtkClipboard *clipboard,
- GdkAtom *atoms,
- gint n_atoms,
- gpointer data);
-
- /* Should these functions have GtkClipboard *clipboard as the first argument?
- * right now for ClearFunc, you may have trouble determining _which_ clipboard
- * was cleared, if you reuse your ClearFunc for multiple clipboards.
- */
- typedef void (* GtkClipboardGetFunc) (GtkClipboard *clipboard,
- GtkSelectionData *selection_data,
- guint info,
- gpointer user_data_or_owner);
- typedef void (* GtkClipboardClearFunc) (GtkClipboard *clipboard,
- gpointer user_data_or_owner);
-
- GType gtk_clipboard_get_type (void) G_GNUC_CONST;
-
- GtkClipboard *gtk_clipboard_get_for_display (GdkDisplay *display,
- GdkAtom selection);
- #ifndef GDK_MULTIHEAD_SAFE
- GtkClipboard *gtk_clipboard_get (GdkAtom selection);
- #endif
-
- GdkDisplay *gtk_clipboard_get_display (GtkClipboard *clipboard);
-
-
- gboolean gtk_clipboard_set_with_data (GtkClipboard *clipboard,
- const GtkTargetEntry *targets,
- guint n_targets,
- GtkClipboardGetFunc get_func,
- GtkClipboardClearFunc clear_func,
- gpointer user_data);
- gboolean gtk_clipboard_set_with_owner (GtkClipboard *clipboard,
- const GtkTargetEntry *targets,
- guint n_targets,
- GtkClipboardGetFunc get_func,
- GtkClipboardClearFunc clear_func,
- GObject *owner);
- GObject *gtk_clipboard_get_owner (GtkClipboard *clipboard);
- void gtk_clipboard_clear (GtkClipboard *clipboard);
- void gtk_clipboard_set_text (GtkClipboard *clipboard,
- const gchar *text,
- gint len);
- void gtk_clipboard_set_image (GtkClipboard *clipboard,
- GdkPixbuf *pixbuf);
-
- void gtk_clipboard_request_contents (GtkClipboard *clipboard,
- GdkAtom target,
- GtkClipboardReceivedFunc callback,
- gpointer user_data);
- void gtk_clipboard_request_text (GtkClipboard *clipboard,
- GtkClipboardTextReceivedFunc callback,
- gpointer user_data);
- void gtk_clipboard_request_rich_text (GtkClipboard *clipboard,
- GtkTextBuffer *buffer,
- GtkClipboardRichTextReceivedFunc callback,
- gpointer user_data);
- void gtk_clipboard_request_image (GtkClipboard *clipboard,
- GtkClipboardImageReceivedFunc callback,
- gpointer user_data);
- void gtk_clipboard_request_uris (GtkClipboard *clipboard,
- GtkClipboardURIReceivedFunc callback,
- gpointer user_data);
- void gtk_clipboard_request_targets (GtkClipboard *clipboard,
- GtkClipboardTargetsReceivedFunc callback,
- gpointer user_data);
-
- GtkSelectionData *gtk_clipboard_wait_for_contents (GtkClipboard *clipboard,
- GdkAtom target);
- gchar * gtk_clipboard_wait_for_text (GtkClipboard *clipboard);
- guint8 * gtk_clipboard_wait_for_rich_text (GtkClipboard *clipboard,
- GtkTextBuffer *buffer,
- GdkAtom *format,
- gsize *length);
- GdkPixbuf * gtk_clipboard_wait_for_image (GtkClipboard *clipboard);
- gchar ** gtk_clipboard_wait_for_uris (GtkClipboard *clipboard);
- gboolean gtk_clipboard_wait_for_targets (GtkClipboard *clipboard,
- GdkAtom **targets,
- gint *n_targets);
-
- gboolean gtk_clipboard_wait_is_text_available (GtkClipboard *clipboard);
- gboolean gtk_clipboard_wait_is_rich_text_available (GtkClipboard *clipboard,
- GtkTextBuffer *buffer);
- gboolean gtk_clipboard_wait_is_image_available (GtkClipboard *clipboard);
- gboolean gtk_clipboard_wait_is_uris_available (GtkClipboard *clipboard);
- gboolean gtk_clipboard_wait_is_target_available (GtkClipboard *clipboard,
- GdkAtom target);
-
-
- void gtk_clipboard_set_can_store (GtkClipboard *clipboard,
- const GtkTargetEntry *targets,
- gint n_targets);
-
- void gtk_clipboard_store (GtkClipboard *clipboard);
-
- /* private */
- void _gtk_clipboard_handle_event (GdkEventOwnerChange *event);
-
- void _gtk_clipboard_store_all (void);
-
- G_END_DECLS
-
- #endif /* __GTK_CLIPBOARD_H__ */
|
