0d10969b9f
2006-04-24 Matthias Clasen <mclasen@redhat.com> * gtk/gtkclipboard.h: * gtk/gtkprinter.c: * gtk/gtkprintsettings.h: * gtk/gtkprintsettings.c: Match parameter names with the headers. * gtk/gtkprintoperation-unix.c (gtk_print_run_page_setup_dialog): Add docs. * gtk/gtktextbufferrichtext.c (gtk_text_buffer_deserialize): * gtk/gtkstatusicon.c (gtk_status_icon_get_storage_type): * gtk/gtktreeview.c (gtk_tree_view_set_search_position_func): * gtk/gtktreeview.c (gtk_tree_view_get_headers_clickable): * gtk/gtkcellrendererspin.c (gtk_cell_renderer_spin_new): * gtk/gtkmenu.c (gtk_menu_get_for_attach_widget): Fix the docs.
146 lines
7.1 KiB
C
146 lines
7.1 KiB
C
/* 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.
|
|
*/
|
|
|
|
#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 (* 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_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);
|
|
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_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__ */
|