← Back to branch summary

~ubuntu-branches/ubuntu/karmic/gtkmm2.4/karmic

« back to all changes in this revision

Viewing changes to docs/reference/html/classGtk_1_1Clipboard.html

  • Committer: Bazaar Package Importer
  • Author(s): Robert Ancell
  • Date: 2009-09-22 10:14:59 UTC
  • mfrom: (1.2.42 upstream)
  • Revision ID: james.westby@ubuntu.com-20090922101459-pespb00fbm1mlqbd
Tags: 1:2.18.1-0ubuntu1
https://launchpad.net/bugs/434355
* New upstream release: (LP: #434355)
  - RecentManager: Undeprecate get_default().
  - Clipboard: wait_for_targets): Fix a crash.
  - Window: Added set_icon_name().
  - Require a recent pangomm.
  - Style: Fix a compiler error with the Intel C++ compiler.
  - Fix recently-introduced problems with disable-deprecated options.
* debian/control.in:
  - Bump libpangomm-1.4-dev depends and build-depends

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/html/classGtk_1_1Clipboard.html
1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
 
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
2
<html xmlns="http://www.w3.org/1999/xhtml">
 
3
<head>
 
4
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
3
5
<title>gtkmm: Gtk::Clipboard Class Reference</title>
4
 
<link href="tabs.css" rel="stylesheet" type="text/css">
5
 
<link href="doxygen.css" rel="stylesheet" type="text/css">
6
 
</head><body>
7
 
<!-- Generated by Doxygen 1.5.8 -->
 
6
<link href="tabs.css" rel="stylesheet" type="text/css"/>
 
7
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
 
8
</head>
 
9
<body>
 
10
<!-- Generated by Doxygen 1.6.1 -->
8
11
<div class="navigation" id="top">
9
12
  <div class="tabs">
10
13
    <ul>
27
30
  </div>
28
31
</div>
29
32
<div class="contents">
30
 
<h1>Gtk::Clipboard Class Reference</h1><!-- doxytag: class="Gtk::Clipboard" --><!-- doxytag: inherits="Glib::Object" -->The <a class="el" href="classGtk_1_1Clipboard.html" title="The Clipboard object represents a clipboard of data shared between different processes...">Clipboard</a> object represents a clipboard of data shared between different processes or between different widgets in the same process. <a href="#_details">More...</a>
31
 
<p>
32
 
Inherits <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html">Glib::Object</a>.
33
 
<p>
 
33
<h1>Gtk::Clipboard Class Reference</h1><!-- doxytag: class="Gtk::Clipboard" --><!-- doxytag: inherits="Glib::Object" -->
 
34
<p>The <a class="el" href="classGtk_1_1Clipboard.html" title="The Clipboard object represents a clipboard of data shared between different processes...">Clipboard</a> object represents a clipboard of data shared between different processes or between different widgets in the same process. <a href="#_details">More...</a></p>
 
35
 
 
36
<p>Inherits <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html">Glib::Object</a>.</p>
34
37
<div class="dynheader">
35
38
Collaboration diagram for Gtk::Clipboard:</div>
36
39
<div class="dynsection">
37
 
<p><center><img src="classGtk_1_1Clipboard__coll__graph.png" border="0" usemap="#Gtk_1_1Clipboard__coll__map" alt="Collaboration graph"></center>
38
 
<map name="Gtk_1_1Clipboard__coll__map">
39
 
<area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="20,155,111,181"><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,80,125,107"><area shape="rect" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="12,5,119,32"></map>
40
 
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
41
 
 
42
 
<p>
43
 
<a href="classGtk_1_1Clipboard-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
44
 
<tr><td></td></tr>
45
 
<tr><td colspan="2"><br><h2>Public Types</h2></td></tr>
46
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void, <br class="typebreak">
47
 
<a class="el" href="classGtk_1_1SelectionData.html">SelectionData</a>&amp;, guint &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#231514c83a1a1d1b14aaee247e522a1f">SlotGet</a></td></tr>
48
 
 
49
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_get(Gtk::SelectionData&amp; selection_data, guint info);. <a href="#231514c83a1a1d1b14aaee247e522a1f"></a><br></td></tr>
50
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#325cb088c615bec5f8d143b44d4741ce">SlotClear</a></td></tr>
51
 
 
52
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_clear();. <a href="#325cb088c615bec5f8d143b44d4741ce"></a><br></td></tr>
53
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void, <br class="typebreak">
54
 
const <a class="el" href="classGtk_1_1SelectionData.html">SelectionData</a>&amp; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#424180e2d14d2bb2f096be10ca2f7059">SlotReceived</a></td></tr>
55
 
 
56
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_received(const SelectionData&amp; selection_data);. <a href="#424180e2d14d2bb2f096be10ca2f7059"></a><br></td></tr>
57
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void, <br class="typebreak">
58
 
const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#8878452bd75d07a5dc2f239ff67e5d9e">SlotTextReceived</a></td></tr>
59
 
 
60
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_text_received(const Glib::ustring&amp; text);. <a href="#8878452bd75d07a5dc2f239ff67e5d9e"></a><br></td></tr>
61
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void, <br class="typebreak">
62
 
const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a> &amp;, const <br class="typebreak">
63
 
<a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00969.html#32db3d9898c44d3b3a578b560f7758cc">std::string</a>&amp; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#39efb49b4cf08d2f08f62aebf368fa32">SlotRichTextReceived</a></td></tr>
64
 
 
65
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_rich_text_received(const Glib::ustring&amp; format, const std::string&amp; text);. <a href="#39efb49b4cf08d2f08f62aebf368fa32"></a><br></td></tr>
66
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void, <br class="typebreak">
67
 
const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>&amp; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#7ec97f4e16280484d0075885c2ca317b">SlotUrisReceived</a></td></tr>
68
 
 
69
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_uris_received(const Glib::StringArrayHandle&amp; uris);. <a href="#7ec97f4e16280484d0075885c2ca317b"></a><br></td></tr>
70
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void, <br class="typebreak">
71
 
const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak">
72
 
&lt; <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a> &gt;&amp; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#2e92912fa27405ef4efafc1d7fe19fe3">SlotImageReceived</a></td></tr>
73
 
 
74
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_image_received(const Glib::RefPtr&lt;Gdk::Pixbuf&gt;&amp; text);. <a href="#2e92912fa27405ef4efafc1d7fe19fe3"></a><br></td></tr>
75
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void, <br class="typebreak">
76
 
const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>&amp; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#d63a6dd13efe8bce4c824c5fb2bbec9f">SlotTargetsReceived</a></td></tr>
77
 
 
78
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_targetsreceived(const Glib::StringArrayHandle&amp; targets);. <a href="#d63a6dd13efe8bce4c824c5fb2bbec9f"></a><br></td></tr>
79
 
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
80
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#4753c62ad3aea992476feaf84574ca05">~Clipboard</a> ()</td></tr>
81
 
 
82
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">GtkClipboard*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#eb465195991ea12f2ee81733a1fa03b0">gobj</a> ()</td></tr>
83
 
 
84
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#eb465195991ea12f2ee81733a1fa03b0"></a><br></td></tr>
85
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">const GtkClipboard*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#307fb72e6fd57d378a981ef0604e4568">gobj</a> () const </td></tr>
86
 
 
87
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#307fb72e6fd57d378a981ef0604e4568"></a><br></td></tr>
88
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">GtkClipboard*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#487b4d31a656a355286187b216d643cd">gobj_copy</a> ()</td></tr>
89
 
 
90
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. <a href="#487b4d31a656a355286187b216d643cd"></a><br></td></tr>
91
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGdk_1_1Display.html">Gdk::Display</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#696d084d1ef3c7cbe298b4e78e8ea167">get_display</a> ()</td></tr>
92
 
 
93
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Gets the <a class="el" href="classGdk_1_1Display.html" title="Gdk::Display object&#39;s purpose is two fold: To grab/ungrab keyboard focus and...">Gdk::Display</a> associated with <em>clipboard</em>. <a href="#696d084d1ef3c7cbe298b4e78e8ea167"></a><br></td></tr>
94
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; const <a class="el" href="classGdk_1_1Display.html">Gdk::Display</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#c9a759c0daf584d22c8af18c24031f0b">get_display</a> () const </td></tr>
95
 
 
96
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Gets the <a class="el" href="classGdk_1_1Display.html" title="Gdk::Display object&#39;s purpose is two fold: To grab/ungrab keyboard focus and...">Gdk::Display</a> associated with <em>clipboard</em>. <a href="#c9a759c0daf584d22c8af18c24031f0b"></a><br></td></tr>
97
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#6eed4302482ee376daf47bf5fcc42605">set</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">ArrayHandle_TargetEntry</a>&amp; targets, const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotGet</a>&amp; slot_get, const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotClear</a>&amp; slot_clear)</td></tr>
98
 
 
99
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Virtually sets the contents of the specified clipboard by providing a list of supported formats for the clipboard data and a function to call to get the actual data when it is requested. <a href="#6eed4302482ee376daf47bf5fcc42605"></a><br></td></tr>
100
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html">Glib::Object</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#77714f58487355b0f34ad154b1a99138">get_owner</a> ()</td></tr>
101
 
 
102
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">If the clipboard contents callbacks were set with set_with_owner(), and the set_with_data() or <a class="el" href="classGtk_1_1Clipboard.html#bf8118f4098f9565f1d85d8d88409a1c" title="Clears the contents of the clipboard.">clear()</a> has not subsequently called, returns the owner set by set_with_owner(). <a href="#77714f58487355b0f34ad154b1a99138"></a><br></td></tr>
103
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html">Glib::Object</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#6c68c91213f935715c5c9b1a612d98f6">get_owner</a> () const </td></tr>
104
 
 
105
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">If the clipboard contents callbacks were set with set_with_owner(), and the set_with_data() or <a class="el" href="classGtk_1_1Clipboard.html#bf8118f4098f9565f1d85d8d88409a1c" title="Clears the contents of the clipboard.">clear()</a> has not subsequently called, returns the owner set by set_with_owner(). <a href="#6c68c91213f935715c5c9b1a612d98f6"></a><br></td></tr>
106
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#bf8118f4098f9565f1d85d8d88409a1c">clear</a> ()</td></tr>
107
 
 
108
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Clears the contents of the clipboard. <a href="#bf8118f4098f9565f1d85d8d88409a1c"></a><br></td></tr>
109
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#aeee306b25ea1e0206e3ffb30af93c32">set_text</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; text)</td></tr>
110
 
 
111
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets the contents of the clipboard to the given UTF-8 string. <a href="#aeee306b25ea1e0206e3ffb30af93c32"></a><br></td></tr>
112
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#49841702b88e06547f48b7f0b9c1fe5d">set_image</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a> &gt;&amp; pixbuf)</td></tr>
113
 
 
114
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets the contents of the clipboard to the given <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a>. <a href="#49841702b88e06547f48b7f0b9c1fe5d"></a><br></td></tr>
115
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#7b89b96071d9d6019eb35203538ac6a6">request_contents</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; target, const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotReceived</a>&amp; slot)</td></tr>
116
 
 
117
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of clipboard as the given target. <a href="#7b89b96071d9d6019eb35203538ac6a6"></a><br></td></tr>
118
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#922ca2e0595b10ec7bcad59632b00f34">request_text</a> (const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotTextReceived</a>&amp; slot)</td></tr>
119
 
 
120
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as text. <a href="#922ca2e0595b10ec7bcad59632b00f34"></a><br></td></tr>
121
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#2fe9763417d17a586bcae713567800d8">request_rich_text</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGtk_1_1TextBuffer.html">TextBuffer</a> &gt;&amp; buffer, const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotRichTextReceived</a>&amp; slot)</td></tr>
122
 
 
123
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as rich text. <a href="#2fe9763417d17a586bcae713567800d8"></a><br></td></tr>
124
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#482e597790498098d3d42751267418bc">request_uris</a> (const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotUrisReceived</a>&amp; slot)</td></tr>
125
 
 
126
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as URIs. <a href="#482e597790498098d3d42751267418bc"></a><br></td></tr>
127
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#cf9daec8f085ea57218a0ced6bc9e949">request_image</a> (const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotImageReceived</a>&amp; slot)</td></tr>
128
 
 
129
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as image. <a href="#cf9daec8f085ea57218a0ced6bc9e949"></a><br></td></tr>
130
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#e3be3a0d85849117a284f8a1cbfdb98e">request_targets</a> (const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotTargetsReceived</a>&amp; slot)</td></tr>
131
 
 
132
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as list of supported targets. <a href="#e3be3a0d85849117a284f8a1cbfdb98e"></a><br></td></tr>
133
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGtk_1_1SelectionData.html">SelectionData</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#2110b8de6c2e61a1cf7d71cc02ef9e47">wait_for_contents</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; target) const </td></tr>
134
 
 
135
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard using the given target. <a href="#2110b8de6c2e61a1cf7d71cc02ef9e47"></a><br></td></tr>
136
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#eac490f4cbb988fe5b6e5eefb33c2201">wait_for_text</a> () const </td></tr>
137
 
 
138
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as text and converts the result to UTF-8 if necessary. <a href="#eac490f4cbb988fe5b6e5eefb33c2201"></a><br></td></tr>
139
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00969.html#32db3d9898c44d3b3a578b560f7758cc">std::string</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#0f02a96840cfe953d1ef30d64c8e1409">wait_for_rich_text</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGtk_1_1TextBuffer.html">TextBuffer</a> &gt;&amp; buffer, <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00969.html#32db3d9898c44d3b3a578b560f7758cc">std::string</a>&amp; format)</td></tr>
140
 
 
141
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#cd3d40ebf095dc8ec7e0ba786ea99b0d">wait_for_image</a> () const </td></tr>
142
 
 
143
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as image and converts the result to a <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a>. <a href="#cd3d40ebf095dc8ec7e0ba786ea99b0d"></a><br></td></tr>
144
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#c30a1145696f41b5feccbbe0346702fc">wait_is_text_available</a> () const </td></tr>
145
 
 
146
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Test to see if there is text available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported text targets. <a href="#c30a1145696f41b5feccbbe0346702fc"></a><br></td></tr>
147
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#05294bafc2322b3688dcc85523ae37db">wait_is_rich_text_available</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGtk_1_1TextBuffer.html">TextBuffer</a> &gt;&amp; buffer) const </td></tr>
148
 
 
149
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Test to see if there is rich text available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported rich text targets. <a href="#05294bafc2322b3688dcc85523ae37db"></a><br></td></tr>
150
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#fcc67f894892de4918e9f8e7fb6813e7">wait_is_image_available</a> () const </td></tr>
151
 
 
152
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Test to see if there is an image available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported image targets. <a href="#fcc67f894892de4918e9f8e7fb6813e7"></a><br></td></tr>
153
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#f0c118eea5e64eabf911558d915af8be">wait_is_uris_available</a> () const </td></tr>
154
 
 
155
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Test to see if there is a list of URIs available to be pasted This is done by requesting the TARGETS atom and checking if it contains the URI targets. <a href="#f0c118eea5e64eabf911558d915af8be"></a><br></td></tr>
156
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#b1c3c7516af21ecb6a2db4db6cb8012b">wait_is_target_available</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; target)</td></tr>
157
 
 
158
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Checks if a clipboard supports pasting data of a given type. <a href="#b1c3c7516af21ecb6a2db4db6cb8012b"></a><br></td></tr>
159
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#168e8bd1b2d97e58ed2ad465dc2f1bf8">wait_for_targets</a> () const </td></tr>
160
 
 
161
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns a list of targets that are present on the clipboard. <a href="#168e8bd1b2d97e58ed2ad465dc2f1bf8"></a><br></td></tr>
162
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#dc50aa1d428322a50d307fc6c0d23dc9">wait_for_uris</a> () const </td></tr>
163
 
 
164
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as URIs. <a href="#dc50aa1d428322a50d307fc6c0d23dc9"></a><br></td></tr>
165
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#89ddaa80ac9aa1664aff952d4f25630f">set_can_store</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">ArrayHandle_TargetEntry</a>&amp; targets)</td></tr>
166
 
 
167
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Hints that the clipboard data should be stored somewhere when the application exits or when <a class="el" href="classGtk_1_1Clipboard.html#47f0293ba7f80821537797537d5b6408" title="Stores the current clipboard data somewhere so that it will stay around after the...">store()</a> is called. <a href="#89ddaa80ac9aa1664aff952d4f25630f"></a><br></td></tr>
168
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#5f2fc04281ab4e2370098bfeb10108ac">set_can_store</a> ()</td></tr>
169
 
 
170
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Hints that all forms of clipboard data should be stored somewhere when the application exits or when <a class="el" href="classGtk_1_1Clipboard.html#47f0293ba7f80821537797537d5b6408" title="Stores the current clipboard data somewhere so that it will stay around after the...">store()</a> is called. <a href="#5f2fc04281ab4e2370098bfeb10108ac"></a><br></td></tr>
171
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#47f0293ba7f80821537797537d5b6408">store</a> ()</td></tr>
172
 
 
173
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Stores the current clipboard data somewhere so that it will stay around after the application has quit. <a href="#47f0293ba7f80821537797537d5b6408"></a><br></td></tr>
174
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>&lt; void, <br class="typebreak">
175
 
GdkEventOwnerChange* &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#3d19cb78841fd7e73fdddca0daeac22b">signal_owner_change</a> ()</td></tr>
176
 
 
177
 
<tr><td colspan="2"><br><h2>Static Public Member Functions</h2></td></tr>
178
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGtk_1_1Clipboard.html">Clipboard</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#163dde254aec1314c6aee6bbdb47fefe">get</a> (GdkAtom selection=GDK_SELECTION_CLIPBOARD)</td></tr>
179
 
 
180
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Return value: the appropriate clipboard object. <a href="#163dde254aec1314c6aee6bbdb47fefe"></a><br></td></tr>
181
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGtk_1_1Clipboard.html">Clipboard</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#880ad980703636e3aed1f25c066ebbc9">get_for_display</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGdk_1_1Display.html">Gdk::Display</a> &gt;&amp; display, GdkAtom selection=GDK_SELECTION_CLIPBOARD)</td></tr>
182
 
 
183
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Return value: the appropriate clipboard object. <a href="#880ad980703636e3aed1f25c066ebbc9"></a><br></td></tr>
184
 
<tr><td colspan="2"><br><h2>Related Functions</h2></td></tr>
185
 
<tr><td colspan="2">(Note that these are not member functions.) <br><br></td></tr>
186
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGtk_1_1Clipboard.html">Gtk::Clipboard</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#d2c721a5e6f7cee3edc204c496a66044">wrap</a> (GtkClipboard* object, bool take_copy=false)</td></tr>
187
 
 
188
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">A <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#d2c721a5e6f7cee3edc204c496a66044"></a><br></td></tr>
 
40
<div class="center"><img src="classGtk_1_1Clipboard__coll__graph.png" border="0" usemap="#Gtk_1_1Clipboard_coll__map" alt="Collaboration graph"/></div>
 
41
<map name="Gtk_1_1Clipboard_coll__map" id="Gtk_1_1Clipboard_coll__map">
 
42
<area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="20,155,111,181"/><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,80,125,107"/><area shape="rect" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="12,5,119,32"/></map>
 
43
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
 
44
 
 
45
<p><a href="classGtk_1_1Clipboard-members.html">List of all members.</a></p>
 
46
<table border="0" cellpadding="0" cellspacing="0">
 
47
<tr><td colspan="2"><h2>Public Types</h2></td></tr>
 
48
<tr><td class="memItemLeft" align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void, <br class="typebreak"/>
 
49
<a class="el" href="classGtk_1_1SelectionData.html">SelectionData</a>&amp;, guint &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a231514c83a1a1d1b14aaee247e522a1f">SlotGet</a></td></tr>
 
50
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_get(Gtk::SelectionData&amp; selection_data, guint info);. <a href="#a231514c83a1a1d1b14aaee247e522a1f"></a><br/></td></tr>
 
51
<tr><td class="memItemLeft" align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a325cb088c615bec5f8d143b44d4741ce">SlotClear</a></td></tr>
 
52
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_clear();. <a href="#a325cb088c615bec5f8d143b44d4741ce"></a><br/></td></tr>
 
53
<tr><td class="memItemLeft" align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void, <br class="typebreak"/>
 
54
const <a class="el" href="classGtk_1_1SelectionData.html">SelectionData</a>&amp; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a424180e2d14d2bb2f096be10ca2f7059">SlotReceived</a></td></tr>
 
55
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_received(const SelectionData&amp; selection_data);. <a href="#a424180e2d14d2bb2f096be10ca2f7059"></a><br/></td></tr>
 
56
<tr><td class="memItemLeft" align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void, <br class="typebreak"/>
 
57
const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a8878452bd75d07a5dc2f239ff67e5d9e">SlotTextReceived</a></td></tr>
 
58
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_text_received(const Glib::ustring&amp; text);. <a href="#a8878452bd75d07a5dc2f239ff67e5d9e"></a><br/></td></tr>
 
59
<tr><td class="memItemLeft" align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void, <br class="typebreak"/>
 
60
const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a> &amp;, const <br class="typebreak"/>
 
61
<a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>&amp; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a39efb49b4cf08d2f08f62aebf368fa32">SlotRichTextReceived</a></td></tr>
 
62
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_rich_text_received(const Glib::ustring&amp; format, const std::string&amp; text);. <a href="#a39efb49b4cf08d2f08f62aebf368fa32"></a><br/></td></tr>
 
63
<tr><td class="memItemLeft" align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void, <br class="typebreak"/>
 
64
const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>&amp; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a7ec97f4e16280484d0075885c2ca317b">SlotUrisReceived</a></td></tr>
 
65
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_uris_received(const Glib::StringArrayHandle&amp; uris);. <a href="#a7ec97f4e16280484d0075885c2ca317b"></a><br/></td></tr>
 
66
<tr><td class="memItemLeft" align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void, <br class="typebreak"/>
 
67
const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/>
 
68
&lt; <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a> &gt;&amp; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a2e92912fa27405ef4efafc1d7fe19fe3">SlotImageReceived</a></td></tr>
 
69
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_image_received(const Glib::RefPtr&lt;Gdk::Pixbuf&gt;&amp; text);. <a href="#a2e92912fa27405ef4efafc1d7fe19fe3"></a><br/></td></tr>
 
70
<tr><td class="memItemLeft" align="right" valign="top">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt; void, <br class="typebreak"/>
 
71
const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>&amp; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#ad63a6dd13efe8bce4c824c5fb2bbec9f">SlotTargetsReceived</a></td></tr>
 
72
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">For instance: void on_targetsreceived(const Glib::StringArrayHandle&amp; targets);. <a href="#ad63a6dd13efe8bce4c824c5fb2bbec9f"></a><br/></td></tr>
 
73
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
 
74
<tr><td class="memItemLeft" align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a4753c62ad3aea992476feaf84574ca05">~Clipboard</a> ()</td></tr>
 
75
<tr><td class="memItemLeft" align="right" valign="top">GtkClipboard*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#aeb465195991ea12f2ee81733a1fa03b0">gobj</a> ()</td></tr>
 
76
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#aeb465195991ea12f2ee81733a1fa03b0"></a><br/></td></tr>
 
77
<tr><td class="memItemLeft" align="right" valign="top">const GtkClipboard*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a307fb72e6fd57d378a981ef0604e4568">gobj</a> () const </td></tr>
 
78
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a307fb72e6fd57d378a981ef0604e4568"></a><br/></td></tr>
 
79
<tr><td class="memItemLeft" align="right" valign="top">GtkClipboard*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a487b4d31a656a355286187b216d643cd">gobj_copy</a> ()</td></tr>
 
80
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. <a href="#a487b4d31a656a355286187b216d643cd"></a><br/></td></tr>
 
81
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGdk_1_1Display.html">Gdk::Display</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a696d084d1ef3c7cbe298b4e78e8ea167">get_display</a> ()</td></tr>
 
82
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Gets the <a class="el" href="classGdk_1_1Display.html" title="Gdk::Display object&#39;s purpose is two fold: To grab/ungrab keyboard focus and...">Gdk::Display</a> associated with <em>clipboard</em>. <a href="#a696d084d1ef3c7cbe298b4e78e8ea167"></a><br/></td></tr>
 
83
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; const <a class="el" href="classGdk_1_1Display.html">Gdk::Display</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#ac9a759c0daf584d22c8af18c24031f0b">get_display</a> () const </td></tr>
 
84
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Gets the <a class="el" href="classGdk_1_1Display.html" title="Gdk::Display object&#39;s purpose is two fold: To grab/ungrab keyboard focus and...">Gdk::Display</a> associated with <em>clipboard</em>. <a href="#ac9a759c0daf584d22c8af18c24031f0b"></a><br/></td></tr>
 
85
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a6eed4302482ee376daf47bf5fcc42605">set</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">ArrayHandle_TargetEntry</a>&amp; targets, const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotGet</a>&amp; slot_get, const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotClear</a>&amp; slot_clear)</td></tr>
 
86
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Virtually sets the contents of the specified clipboard by providing a list of supported formats for the clipboard data and a function to call to get the actual data when it is requested. <a href="#a6eed4302482ee376daf47bf5fcc42605"></a><br/></td></tr>
 
87
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html">Glib::Object</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a77714f58487355b0f34ad154b1a99138">get_owner</a> ()</td></tr>
 
88
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">If the clipboard contents callbacks were set with set_with_owner(), and the set_with_data() or <a class="el" href="classGtk_1_1Clipboard.html#abf8118f4098f9565f1d85d8d88409a1c" title="Clears the contents of the clipboard.">clear()</a> has not subsequently called, returns the owner set by set_with_owner(). <a href="#a77714f58487355b0f34ad154b1a99138"></a><br/></td></tr>
 
89
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html">Glib::Object</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a6c68c91213f935715c5c9b1a612d98f6">get_owner</a> () const </td></tr>
 
90
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">If the clipboard contents callbacks were set with set_with_owner(), and the set_with_data() or <a class="el" href="classGtk_1_1Clipboard.html#abf8118f4098f9565f1d85d8d88409a1c" title="Clears the contents of the clipboard.">clear()</a> has not subsequently called, returns the owner set by set_with_owner(). <a href="#a6c68c91213f935715c5c9b1a612d98f6"></a><br/></td></tr>
 
91
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#abf8118f4098f9565f1d85d8d88409a1c">clear</a> ()</td></tr>
 
92
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Clears the contents of the clipboard. <a href="#abf8118f4098f9565f1d85d8d88409a1c"></a><br/></td></tr>
 
93
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#aaeee306b25ea1e0206e3ffb30af93c32">set_text</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; text)</td></tr>
 
94
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets the contents of the clipboard to the given UTF-8 string. <a href="#aaeee306b25ea1e0206e3ffb30af93c32"></a><br/></td></tr>
 
95
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a49841702b88e06547f48b7f0b9c1fe5d">set_image</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a> &gt;&amp; pixbuf)</td></tr>
 
96
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets the contents of the clipboard to the given <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a>. <a href="#a49841702b88e06547f48b7f0b9c1fe5d"></a><br/></td></tr>
 
97
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a7b89b96071d9d6019eb35203538ac6a6">request_contents</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; target, const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotReceived</a>&amp; slot)</td></tr>
 
98
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of clipboard as the given target. <a href="#a7b89b96071d9d6019eb35203538ac6a6"></a><br/></td></tr>
 
99
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a922ca2e0595b10ec7bcad59632b00f34">request_text</a> (const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotTextReceived</a>&amp; slot)</td></tr>
 
100
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as text. <a href="#a922ca2e0595b10ec7bcad59632b00f34"></a><br/></td></tr>
 
101
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a2fe9763417d17a586bcae713567800d8">request_rich_text</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGtk_1_1TextBuffer.html">TextBuffer</a> &gt;&amp; buffer, const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotRichTextReceived</a>&amp; slot)</td></tr>
 
102
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as rich text. <a href="#a2fe9763417d17a586bcae713567800d8"></a><br/></td></tr>
 
103
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a482e597790498098d3d42751267418bc">request_uris</a> (const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotUrisReceived</a>&amp; slot)</td></tr>
 
104
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as URIs. <a href="#a482e597790498098d3d42751267418bc"></a><br/></td></tr>
 
105
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#acf9daec8f085ea57218a0ced6bc9e949">request_image</a> (const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotImageReceived</a>&amp; slot)</td></tr>
 
106
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as image. <a href="#acf9daec8f085ea57218a0ced6bc9e949"></a><br/></td></tr>
 
107
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#ae3be3a0d85849117a284f8a1cbfdb98e">request_targets</a> (const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotTargetsReceived</a>&amp; slot)</td></tr>
 
108
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as list of supported targets. <a href="#ae3be3a0d85849117a284f8a1cbfdb98e"></a><br/></td></tr>
 
109
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1SelectionData.html">SelectionData</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a2110b8de6c2e61a1cf7d71cc02ef9e47">wait_for_contents</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; target) const </td></tr>
 
110
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard using the given target. <a href="#a2110b8de6c2e61a1cf7d71cc02ef9e47"></a><br/></td></tr>
 
111
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#aeac490f4cbb988fe5b6e5eefb33c2201">wait_for_text</a> () const </td></tr>
 
112
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as text and converts the result to UTF-8 if necessary. <a href="#aeac490f4cbb988fe5b6e5eefb33c2201"></a><br/></td></tr>
 
113
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a0f02a96840cfe953d1ef30d64c8e1409">wait_for_rich_text</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGtk_1_1TextBuffer.html">TextBuffer</a> &gt;&amp; buffer, <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>&amp; format)</td></tr>
 
114
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#acd3d40ebf095dc8ec7e0ba786ea99b0d">wait_for_image</a> () const </td></tr>
 
115
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as image and converts the result to a <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a>. <a href="#acd3d40ebf095dc8ec7e0ba786ea99b0d"></a><br/></td></tr>
 
116
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#ac30a1145696f41b5feccbbe0346702fc">wait_is_text_available</a> () const </td></tr>
 
117
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Test to see if there is text available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported text targets. <a href="#ac30a1145696f41b5feccbbe0346702fc"></a><br/></td></tr>
 
118
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a05294bafc2322b3688dcc85523ae37db">wait_is_rich_text_available</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGtk_1_1TextBuffer.html">TextBuffer</a> &gt;&amp; buffer) const </td></tr>
 
119
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Test to see if there is rich text available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported rich text targets. <a href="#a05294bafc2322b3688dcc85523ae37db"></a><br/></td></tr>
 
120
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#afcc67f894892de4918e9f8e7fb6813e7">wait_is_image_available</a> () const </td></tr>
 
121
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Test to see if there is an image available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported image targets. <a href="#afcc67f894892de4918e9f8e7fb6813e7"></a><br/></td></tr>
 
122
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#af0c118eea5e64eabf911558d915af8be">wait_is_uris_available</a> () const </td></tr>
 
123
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Test to see if there is a list of URIs available to be pasted This is done by requesting the TARGETS atom and checking if it contains the URI targets. <a href="#af0c118eea5e64eabf911558d915af8be"></a><br/></td></tr>
 
124
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#ab1c3c7516af21ecb6a2db4db6cb8012b">wait_is_target_available</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; target)</td></tr>
 
125
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Checks if a clipboard supports pasting data of a given type. <a href="#ab1c3c7516af21ecb6a2db4db6cb8012b"></a><br/></td></tr>
 
126
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a168e8bd1b2d97e58ed2ad465dc2f1bf8">wait_for_targets</a> () const </td></tr>
 
127
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns a list of targets that are present on the clipboard. <a href="#a168e8bd1b2d97e58ed2ad465dc2f1bf8"></a><br/></td></tr>
 
128
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#adc50aa1d428322a50d307fc6c0d23dc9">wait_for_uris</a> () const </td></tr>
 
129
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Requests the contents of the clipboard as URIs. <a href="#adc50aa1d428322a50d307fc6c0d23dc9"></a><br/></td></tr>
 
130
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a89ddaa80ac9aa1664aff952d4f25630f">set_can_store</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">ArrayHandle_TargetEntry</a>&amp; targets)</td></tr>
 
131
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Hints that the clipboard data should be stored somewhere when the application exits or when <a class="el" href="classGtk_1_1Clipboard.html#a47f0293ba7f80821537797537d5b6408" title="Stores the current clipboard data somewhere so that it will stay around after the...">store()</a> is called. <a href="#a89ddaa80ac9aa1664aff952d4f25630f"></a><br/></td></tr>
 
132
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a5f2fc04281ab4e2370098bfeb10108ac">set_can_store</a> ()</td></tr>
 
133
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Hints that all forms of clipboard data should be stored somewhere when the application exits or when <a class="el" href="classGtk_1_1Clipboard.html#a47f0293ba7f80821537797537d5b6408" title="Stores the current clipboard data somewhere so that it will stay around after the...">store()</a> is called. <a href="#a5f2fc04281ab4e2370098bfeb10108ac"></a><br/></td></tr>
 
134
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a47f0293ba7f80821537797537d5b6408">store</a> ()</td></tr>
 
135
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Stores the current clipboard data somewhere so that it will stay around after the application has quit. <a href="#a47f0293ba7f80821537797537d5b6408"></a><br/></td></tr>
 
136
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>&lt; void, <br class="typebreak"/>
 
137
GdkEventOwnerChange* &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a3d19cb78841fd7e73fdddca0daeac22b">signal_owner_change</a> ()</td></tr>
 
138
<tr><td colspan="2"><h2>Static Public Member Functions</h2></td></tr>
 
139
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGtk_1_1Clipboard.html">Clipboard</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a163dde254aec1314c6aee6bbdb47fefe">get</a> (GdkAtom selection=GDK_SELECTION_CLIPBOARD)</td></tr>
 
140
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Return value: the appropriate clipboard object. <a href="#a163dde254aec1314c6aee6bbdb47fefe"></a><br/></td></tr>
 
141
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGtk_1_1Clipboard.html">Clipboard</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#a880ad980703636e3aed1f25c066ebbc9">get_for_display</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGdk_1_1Display.html">Gdk::Display</a> &gt;&amp; display, GdkAtom selection=GDK_SELECTION_CLIPBOARD)</td></tr>
 
142
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Return value: the appropriate clipboard object. <a href="#a880ad980703636e3aed1f25c066ebbc9"></a><br/></td></tr>
 
143
<tr><td colspan="2"><h2>Related Functions</h2></td></tr>
 
144
<tr><td colspan="2"><p>(Note that these are not member functions.) </p>
 
145
<br/><br/></td></tr>
 
146
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGtk_1_1Clipboard.html">Gtk::Clipboard</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Clipboard.html#ad2c721a5e6f7cee3edc204c496a66044">wrap</a> (GtkClipboard* object, bool take_copy=false)</td></tr>
 
147
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">A <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#ad2c721a5e6f7cee3edc204c496a66044"></a><br/></td></tr>
189
148
</table>
190
 
<hr><a name="_details"></a><h2>Detailed Description</h2>
191
 
The <a class="el" href="classGtk_1_1Clipboard.html" title="The Clipboard object represents a clipboard of data shared between different processes...">Clipboard</a> object represents a clipboard of data shared between different processes or between different widgets in the same process. <p>
192
 
Each clipboard is identified by a name encoded as a GdkAtom. * (Conversion to and from strings can be done with gdk_atom_intern() and gdk_atom_name().) The default clipboard corresponds to the "CLIPBOARD" atom; another commonly used clipboard is the "PRIMARY" clipboard, which, in X, traditionally contains the currently selected text.<p>
193
 
To support having a number of different formats on the clipboard at the same time, the clipboard mechanism allows providing callbacks instead of the actual data. When you set the contents of the clipboard, you can either supply the data directly (via functions like <a class="el" href="classGtk_1_1Clipboard.html#aeee306b25ea1e0206e3ffb30af93c32" title="Sets the contents of the clipboard to the given UTF-8 string.">set_text()</a>), or you can supply a callback to be called at a later time when the data is needed (via <a class="el" href="classGtk_1_1Clipboard.html#6eed4302482ee376daf47bf5fcc42605" title="Virtually sets the contents of the specified clipboard by providing a list of supported...">set()</a>.) Providing a callback also avoids having to make copies of the data when it is not needed.<p>
194
 
Requesting the data from the clipboard is essentially asynchronous. If the contents of the clipboard are provided within the same process, then a direct function call will be made to retrieve the data, but if they are provided by another process, then the data needs to be retrieved from the other process, which may take some time. To avoid blocking the user interface, the call to request the selection, <a class="el" href="classGtk_1_1Clipboard.html#7b89b96071d9d6019eb35203538ac6a6" title="Requests the contents of clipboard as the given target.">request_contents()</a> takes a callback that will be called when the contents are received (or when the request fails.) If you don't want to deal with providing a separate callback, you can also use <a class="el" href="classGtk_1_1Clipboard.html#2110b8de6c2e61a1cf7d71cc02ef9e47" title="Requests the contents of the clipboard using the given target.">wait_for_contents()</a>. This runs the GLib main loop recursively waiting for the contents. This can simplify the code flow, but you still have to be aware that other callbacks in your program can be called while this recursive mainloop is running.<p>
195
 
Along with the functions to get the clipboard contents as an arbitrary data chunk, there are also functions to retrieve it as text, <a class="el" href="classGtk_1_1Clipboard.html#922ca2e0595b10ec7bcad59632b00f34" title="Requests the contents of the clipboard as text.">request_text()</a> and <a class="el" href="classGtk_1_1Clipboard.html#eac490f4cbb988fe5b6e5eefb33c2201" title="Requests the contents of the clipboard as text and converts the result to UTF-8 if...">wait_for_text()</a>. These functions take care of determining which formats are advertised by the clipboard provider, asking for the clipboard in the best available format and converting the results into the UTF-8 encoding. <hr><h2>Member Typedef Documentation</h2>
196
 
<a class="anchor" name="325cb088c615bec5f8d143b44d4741ce"></a><!-- doxytag: member="Gtk::Clipboard::SlotClear" ref="325cb088c615bec5f8d143b44d4741ce" args="" -->
197
 
<div class="memitem">
198
 
<div class="memproto">
199
 
      <table class="memname">
200
 
        <tr>
201
 
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotClear</a> </td>
202
 
        </tr>
203
 
      </table>
204
 
</div>
205
 
<div class="memdoc">
206
 
 
207
 
<p>
208
 
For instance: void on_clear();. <p>
209
 
 
210
 
</div>
211
 
</div><p>
212
 
<a class="anchor" name="231514c83a1a1d1b14aaee247e522a1f"></a><!-- doxytag: member="Gtk::Clipboard::SlotGet" ref="231514c83a1a1d1b14aaee247e522a1f" args="" -->
213
 
<div class="memitem">
214
 
<div class="memproto">
215
 
      <table class="memname">
216
 
        <tr>
217
 
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void, <a class="el" href="classGtk_1_1SelectionData.html">SelectionData</a>&amp;, guint&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotGet</a> </td>
218
 
        </tr>
219
 
      </table>
220
 
</div>
221
 
<div class="memdoc">
222
 
 
223
 
<p>
224
 
For instance: void on_get(Gtk::SelectionData&amp; selection_data, guint info);. <p>
225
 
 
226
 
</div>
227
 
</div><p>
228
 
<a class="anchor" name="2e92912fa27405ef4efafc1d7fe19fe3"></a><!-- doxytag: member="Gtk::Clipboard::SlotImageReceived" ref="2e92912fa27405ef4efafc1d7fe19fe3" args="" -->
229
 
<div class="memitem">
230
 
<div class="memproto">
231
 
      <table class="memname">
232
 
        <tr>
233
 
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void, const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a>&gt;&amp;&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotImageReceived</a> </td>
234
 
        </tr>
235
 
      </table>
236
 
</div>
237
 
<div class="memdoc">
238
 
 
239
 
<p>
240
 
For instance: void on_image_received(const Glib::RefPtr&lt;Gdk::Pixbuf&gt;&amp; text);. <p>
241
 
 
242
 
</div>
243
 
</div><p>
244
 
<a class="anchor" name="424180e2d14d2bb2f096be10ca2f7059"></a><!-- doxytag: member="Gtk::Clipboard::SlotReceived" ref="424180e2d14d2bb2f096be10ca2f7059" args="" -->
245
 
<div class="memitem">
246
 
<div class="memproto">
247
 
      <table class="memname">
248
 
        <tr>
249
 
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void, const <a class="el" href="classGtk_1_1SelectionData.html">SelectionData</a>&amp;&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotReceived</a> </td>
250
 
        </tr>
251
 
      </table>
252
 
</div>
253
 
<div class="memdoc">
254
 
 
255
 
<p>
256
 
For instance: void on_received(const SelectionData&amp; selection_data);. <p>
257
 
 
258
 
</div>
259
 
</div><p>
260
 
<a class="anchor" name="39efb49b4cf08d2f08f62aebf368fa32"></a><!-- doxytag: member="Gtk::Clipboard::SlotRichTextReceived" ref="39efb49b4cf08d2f08f62aebf368fa32" args="" -->
261
 
<div class="memitem">
262
 
<div class="memproto">
263
 
      <table class="memname">
264
 
        <tr>
265
 
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void, const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp;, const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00969.html#32db3d9898c44d3b3a578b560f7758cc">std::string</a>&amp;&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotRichTextReceived</a> </td>
266
 
        </tr>
267
 
      </table>
268
 
</div>
269
 
<div class="memdoc">
270
 
 
271
 
<p>
272
 
For instance: void on_rich_text_received(const Glib::ustring&amp; format, const std::string&amp; text);. <p>
273
 
 
274
 
</div>
275
 
</div><p>
276
 
<a class="anchor" name="d63a6dd13efe8bce4c824c5fb2bbec9f"></a><!-- doxytag: member="Gtk::Clipboard::SlotTargetsReceived" ref="d63a6dd13efe8bce4c824c5fb2bbec9f" args="" -->
277
 
<div class="memitem">
278
 
<div class="memproto">
279
 
      <table class="memname">
280
 
        <tr>
281
 
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void, const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>&amp;&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotTargetsReceived</a> </td>
282
 
        </tr>
283
 
      </table>
284
 
</div>
285
 
<div class="memdoc">
286
 
 
287
 
<p>
288
 
For instance: void on_targetsreceived(const Glib::StringArrayHandle&amp; targets);. <p>
289
 
 
290
 
</div>
291
 
</div><p>
292
 
<a class="anchor" name="8878452bd75d07a5dc2f239ff67e5d9e"></a><!-- doxytag: member="Gtk::Clipboard::SlotTextReceived" ref="8878452bd75d07a5dc2f239ff67e5d9e" args="" -->
293
 
<div class="memitem">
294
 
<div class="memproto">
295
 
      <table class="memname">
296
 
        <tr>
297
 
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void, const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp;&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotTextReceived</a> </td>
298
 
        </tr>
299
 
      </table>
300
 
</div>
301
 
<div class="memdoc">
302
 
 
303
 
<p>
304
 
For instance: void on_text_received(const Glib::ustring&amp; text);. <p>
305
 
 
306
 
</div>
307
 
</div><p>
308
 
<a class="anchor" name="7ec97f4e16280484d0075885c2ca317b"></a><!-- doxytag: member="Gtk::Clipboard::SlotUrisReceived" ref="7ec97f4e16280484d0075885c2ca317b" args="" -->
309
 
<div class="memitem">
310
 
<div class="memproto">
311
 
      <table class="memname">
312
 
        <tr>
313
 
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void, const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>&amp;&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotUrisReceived</a> </td>
314
 
        </tr>
315
 
      </table>
316
 
</div>
317
 
<div class="memdoc">
318
 
 
319
 
<p>
320
 
For instance: void on_uris_received(const Glib::StringArrayHandle&amp; uris);. <p>
321
 
 
322
 
</div>
323
 
</div><p>
324
 
<hr><h2>Constructor &amp; Destructor Documentation</h2>
325
 
<a class="anchor" name="4753c62ad3aea992476feaf84574ca05"></a><!-- doxytag: member="Gtk::Clipboard::~Clipboard" ref="4753c62ad3aea992476feaf84574ca05" args="()" -->
 
149
<hr/><a name="_details"></a><h2>Detailed Description</h2>
 
150
<p>The <a class="el" href="classGtk_1_1Clipboard.html" title="The Clipboard object represents a clipboard of data shared between different processes...">Clipboard</a> object represents a clipboard of data shared between different processes or between different widgets in the same process. </p>
 
151
<p>Each clipboard is identified by a name encoded as a GdkAtom. * (Conversion to and from strings can be done with gdk_atom_intern() and gdk_atom_name().) The default clipboard corresponds to the "CLIPBOARD" atom; another commonly used clipboard is the "PRIMARY" clipboard, which, in X, traditionally contains the currently selected text.</p>
 
152
<p>To support having a number of different formats on the clipboard at the same time, the clipboard mechanism allows providing callbacks instead of the actual data. When you set the contents of the clipboard, you can either supply the data directly (via functions like <a class="el" href="classGtk_1_1Clipboard.html#aaeee306b25ea1e0206e3ffb30af93c32" title="Sets the contents of the clipboard to the given UTF-8 string.">set_text()</a>), or you can supply a callback to be called at a later time when the data is needed (via <a class="el" href="classGtk_1_1Clipboard.html#a6eed4302482ee376daf47bf5fcc42605" title="Virtually sets the contents of the specified clipboard by providing a list of supported...">set()</a>.) Providing a callback also avoids having to make copies of the data when it is not needed.</p>
 
153
<p>Requesting the data from the clipboard is essentially asynchronous. If the contents of the clipboard are provided within the same process, then a direct function call will be made to retrieve the data, but if they are provided by another process, then the data needs to be retrieved from the other process, which may take some time. To avoid blocking the user interface, the call to request the selection, <a class="el" href="classGtk_1_1Clipboard.html#a7b89b96071d9d6019eb35203538ac6a6" title="Requests the contents of clipboard as the given target.">request_contents()</a> takes a callback that will be called when the contents are received (or when the request fails.) If you don't want to deal with providing a separate callback, you can also use <a class="el" href="classGtk_1_1Clipboard.html#a2110b8de6c2e61a1cf7d71cc02ef9e47" title="Requests the contents of the clipboard using the given target.">wait_for_contents()</a>. This runs the GLib main loop recursively waiting for the contents. This can simplify the code flow, but you still have to be aware that other callbacks in your program can be called while this recursive mainloop is running.</p>
 
154
<p>Along with the functions to get the clipboard contents as an arbitrary data chunk, there are also functions to retrieve it as text, <a class="el" href="classGtk_1_1Clipboard.html#a922ca2e0595b10ec7bcad59632b00f34" title="Requests the contents of the clipboard as text.">request_text()</a> and <a class="el" href="classGtk_1_1Clipboard.html#aeac490f4cbb988fe5b6e5eefb33c2201" title="Requests the contents of the clipboard as text and converts the result to UTF-8 if...">wait_for_text()</a>. These functions take care of determining which formats are advertised by the clipboard provider, asking for the clipboard in the best available format and converting the results into the UTF-8 encoding. </p>
 
155
<hr/><h2>Member Typedef Documentation</h2>
 
156
<a class="anchor" id="a325cb088c615bec5f8d143b44d4741ce"></a><!-- doxytag: member="Gtk::Clipboard::SlotClear" ref="a325cb088c615bec5f8d143b44d4741ce" args="" -->
 
157
<div class="memitem">
 
158
<div class="memproto">
 
159
      <table class="memname">
 
160
        <tr>
 
161
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotClear</a></td>
 
162
        </tr>
 
163
      </table>
 
164
</div>
 
165
<div class="memdoc">
 
166
 
 
167
<p>For instance: void on_clear();. </p>
 
168
 
 
169
</div>
 
170
</div>
 
171
<a class="anchor" id="a231514c83a1a1d1b14aaee247e522a1f"></a><!-- doxytag: member="Gtk::Clipboard::SlotGet" ref="a231514c83a1a1d1b14aaee247e522a1f" args="" -->
 
172
<div class="memitem">
 
173
<div class="memproto">
 
174
      <table class="memname">
 
175
        <tr>
 
176
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void, <a class="el" href="classGtk_1_1SelectionData.html">SelectionData</a>&amp;, guint&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotGet</a></td>
 
177
        </tr>
 
178
      </table>
 
179
</div>
 
180
<div class="memdoc">
 
181
 
 
182
<p>For instance: void on_get(Gtk::SelectionData&amp; selection_data, guint info);. </p>
 
183
 
 
184
</div>
 
185
</div>
 
186
<a class="anchor" id="a2e92912fa27405ef4efafc1d7fe19fe3"></a><!-- doxytag: member="Gtk::Clipboard::SlotImageReceived" ref="a2e92912fa27405ef4efafc1d7fe19fe3" args="" -->
 
187
<div class="memitem">
 
188
<div class="memproto">
 
189
      <table class="memname">
 
190
        <tr>
 
191
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void, const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a>&gt;&amp;&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotImageReceived</a></td>
 
192
        </tr>
 
193
      </table>
 
194
</div>
 
195
<div class="memdoc">
 
196
 
 
197
<p>For instance: void on_image_received(const Glib::RefPtr&lt;Gdk::Pixbuf&gt;&amp; text);. </p>
 
198
 
 
199
</div>
 
200
</div>
 
201
<a class="anchor" id="a424180e2d14d2bb2f096be10ca2f7059"></a><!-- doxytag: member="Gtk::Clipboard::SlotReceived" ref="a424180e2d14d2bb2f096be10ca2f7059" args="" -->
 
202
<div class="memitem">
 
203
<div class="memproto">
 
204
      <table class="memname">
 
205
        <tr>
 
206
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void, const <a class="el" href="classGtk_1_1SelectionData.html">SelectionData</a>&amp;&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotReceived</a></td>
 
207
        </tr>
 
208
      </table>
 
209
</div>
 
210
<div class="memdoc">
 
211
 
 
212
<p>For instance: void on_received(const SelectionData&amp; selection_data);. </p>
 
213
 
 
214
</div>
 
215
</div>
 
216
<a class="anchor" id="a39efb49b4cf08d2f08f62aebf368fa32"></a><!-- doxytag: member="Gtk::Clipboard::SlotRichTextReceived" ref="a39efb49b4cf08d2f08f62aebf368fa32" args="" -->
 
217
<div class="memitem">
 
218
<div class="memproto">
 
219
      <table class="memname">
 
220
        <tr>
 
221
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void, const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp;, const <a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>&amp;&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotRichTextReceived</a></td>
 
222
        </tr>
 
223
      </table>
 
224
</div>
 
225
<div class="memdoc">
 
226
 
 
227
<p>For instance: void on_rich_text_received(const Glib::ustring&amp; format, const std::string&amp; text);. </p>
 
228
 
 
229
</div>
 
230
</div>
 
231
<a class="anchor" id="ad63a6dd13efe8bce4c824c5fb2bbec9f"></a><!-- doxytag: member="Gtk::Clipboard::SlotTargetsReceived" ref="ad63a6dd13efe8bce4c824c5fb2bbec9f" args="" -->
 
232
<div class="memitem">
 
233
<div class="memproto">
 
234
      <table class="memname">
 
235
        <tr>
 
236
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void, const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>&amp;&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotTargetsReceived</a></td>
 
237
        </tr>
 
238
      </table>
 
239
</div>
 
240
<div class="memdoc">
 
241
 
 
242
<p>For instance: void on_targetsreceived(const Glib::StringArrayHandle&amp; targets);. </p>
 
243
 
 
244
</div>
 
245
</div>
 
246
<a class="anchor" id="a8878452bd75d07a5dc2f239ff67e5d9e"></a><!-- doxytag: member="Gtk::Clipboard::SlotTextReceived" ref="a8878452bd75d07a5dc2f239ff67e5d9e" args="" -->
 
247
<div class="memitem">
 
248
<div class="memproto">
 
249
      <table class="memname">
 
250
        <tr>
 
251
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void, const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp;&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotTextReceived</a></td>
 
252
        </tr>
 
253
      </table>
 
254
</div>
 
255
<div class="memdoc">
 
256
 
 
257
<p>For instance: void on_text_received(const Glib::ustring&amp; text);. </p>
 
258
 
 
259
</div>
 
260
</div>
 
261
<a class="anchor" id="a7ec97f4e16280484d0075885c2ca317b"></a><!-- doxytag: member="Gtk::Clipboard::SlotUrisReceived" ref="a7ec97f4e16280484d0075885c2ca317b" args="" -->
 
262
<div class="memitem">
 
263
<div class="memproto">
 
264
      <table class="memname">
 
265
        <tr>
 
266
          <td class="memname">typedef <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">sigc::slot</a>&lt;void, const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a>&amp;&gt; <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">Gtk::Clipboard::SlotUrisReceived</a></td>
 
267
        </tr>
 
268
      </table>
 
269
</div>
 
270
<div class="memdoc">
 
271
 
 
272
<p>For instance: void on_uris_received(const Glib::StringArrayHandle&amp; uris);. </p>
 
273
 
 
274
</div>
 
275
</div>
 
276
<hr/><h2>Constructor &amp; Destructor Documentation</h2>
 
277
<a class="anchor" id="a4753c62ad3aea992476feaf84574ca05"></a><!-- doxytag: member="Gtk::Clipboard::~Clipboard" ref="a4753c62ad3aea992476feaf84574ca05" args="()" -->
326
278
<div class="memitem">
327
279
<div class="memproto">
328
280
      <table class="memname">
329
281
        <tr>
330
282
          <td class="memname">virtual Gtk::Clipboard::~Clipboard </td>
331
283
          <td>(</td>
332
 
          <td class="paramname"> </td>
 
284
          <td class="paramname"></td>
333
285
          <td>&#160;)&#160;</td>
334
286
          <td><code> [virtual]</code></td>
335
287
        </tr>
337
289
</div>
338
290
<div class="memdoc">
339
291
 
340
 
<p>
341
 
 
342
 
</div>
343
 
</div><p>
344
 
<hr><h2>Member Function Documentation</h2>
345
 
<a class="anchor" name="bf8118f4098f9565f1d85d8d88409a1c"></a><!-- doxytag: member="Gtk::Clipboard::clear" ref="bf8118f4098f9565f1d85d8d88409a1c" args="()" -->
 
292
</div>
 
293
</div>
 
294
<hr/><h2>Member Function Documentation</h2>
 
295
<a class="anchor" id="abf8118f4098f9565f1d85d8d88409a1c"></a><!-- doxytag: member="Gtk::Clipboard::clear" ref="abf8118f4098f9565f1d85d8d88409a1c" args="()" -->
346
296
<div class="memitem">
347
297
<div class="memproto">
348
298
      <table class="memname">
349
299
        <tr>
350
300
          <td class="memname">void Gtk::Clipboard::clear </td>
351
301
          <td>(</td>
352
 
          <td class="paramname"> </td>
 
302
          <td class="paramname"></td>
353
303
          <td>&#160;)&#160;</td>
354
304
          <td></td>
355
305
        </tr>
357
307
</div>
358
308
<div class="memdoc">
359
309
 
360
 
<p>
361
 
Clears the contents of the clipboard. <p>
362
 
Generally this should only be called between the time you call <a class="el" href="classGtk_1_1Clipboard.html#6eed4302482ee376daf47bf5fcc42605" title="Virtually sets the contents of the specified clipboard by providing a list of supported...">set()</a> and when the slot_clear you supplied is called. Otherwise, the clipboard may be owned by someone else. Clears the contents of the clipboard. Generally this should only be called between the time you call set_with_owner() or set_with_data(), and when the <em>clear_func</em> you supplied is called. Otherwise, the clipboard may be owned by someone else. </div>
363
 
</div><p>
364
 
<a class="anchor" name="163dde254aec1314c6aee6bbdb47fefe"></a><!-- doxytag: member="Gtk::Clipboard::get" ref="163dde254aec1314c6aee6bbdb47fefe" args="(GdkAtom selection=GDK_SELECTION_CLIPBOARD)" -->
 
310
<p>Clears the contents of the clipboard. </p>
 
311
<p>Generally this should only be called between the time you call <a class="el" href="classGtk_1_1Clipboard.html#a6eed4302482ee376daf47bf5fcc42605" title="Virtually sets the contents of the specified clipboard by providing a list of supported...">set()</a> and when the slot_clear you supplied is called. Otherwise, the clipboard may be owned by someone else. </p>
 
312
 
 
313
</div>
 
314
</div>
 
315
<a class="anchor" id="a163dde254aec1314c6aee6bbdb47fefe"></a><!-- doxytag: member="Gtk::Clipboard::get" ref="a163dde254aec1314c6aee6bbdb47fefe" args="(GdkAtom selection=GDK_SELECTION_CLIPBOARD)" -->
365
316
<div class="memitem">
366
317
<div class="memproto">
367
318
      <table class="memname">
369
320
          <td class="memname">static <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGtk_1_1Clipboard.html">Clipboard</a>&gt; Gtk::Clipboard::get </td>
370
321
          <td>(</td>
371
322
          <td class="paramtype">GdkAtom&#160;</td>
372
 
          <td class="paramname"> <em>selection</em> = <code>GDK_SELECTION_CLIPBOARD</code> </td>
 
323
          <td class="paramname"> <em>selection</em> = <code>GDK_SELECTION_CLIPBOARD</code></td>
373
324
          <td>&#160;)&#160;</td>
374
325
          <td><code> [static]</code></td>
375
326
        </tr>
377
328
</div>
378
329
<div class="memdoc">
379
330
 
380
 
<p>
381
 
Return value: the appropriate clipboard object. <p>
382
 
If no <dl compact><dt><b>Parameters:</b></dt><dd>
 
331
<p>Return value: the appropriate clipboard object. </p>
 
332
<p>If no </p>
 
333
<dl><dt><b>Parameters:</b></dt><dd>
383
334
  <table border="0" cellspacing="2" cellpadding="0">
384
335
    <tr><td valign="top"></td><td valign="top"><em>selection</em>&#160;</td><td>A Gdk::Atom which identifies the clipboard to use. </td></tr>
385
336
  </table>
 
337
  </dd>
386
338
</dl>
387
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The appropriate clipboard object. If no clipboard already exists, a new one will be created. Once a clipboard object has been created, it is persistent and, since it is owned by GTK+, must not be freed or unrefd. </dd></dl>
 
339
<dl class="return"><dt><b>Returns:</b></dt><dd>The appropriate clipboard object. If no clipboard already exists, a new one will be created. Once a clipboard object has been created, it is persistent and, since it is owned by GTK+, must not be freed or unrefd. </dd></dl>
388
340
 
389
341
</div>
390
 
</div><p>
391
 
<a class="anchor" name="c9a759c0daf584d22c8af18c24031f0b"></a><!-- doxytag: member="Gtk::Clipboard::get_display" ref="c9a759c0daf584d22c8af18c24031f0b" args="() const " -->
 
342
</div>
 
343
<a class="anchor" id="ac9a759c0daf584d22c8af18c24031f0b"></a><!-- doxytag: member="Gtk::Clipboard::get_display" ref="ac9a759c0daf584d22c8af18c24031f0b" args="() const " -->
392
344
<div class="memitem">
393
345
<div class="memproto">
394
346
      <table class="memname">
395
347
        <tr>
396
348
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classGdk_1_1Display.html">Gdk::Display</a>&gt; Gtk::Clipboard::get_display </td>
397
349
          <td>(</td>
398
 
          <td class="paramname"> </td>
 
350
          <td class="paramname"></td>
399
351
          <td>&#160;)&#160;</td>
400
352
          <td> const</td>
401
353
        </tr>
403
355
</div>
404
356
<div class="memdoc">
405
357
 
406
 
<p>
407
 
Gets the <a class="el" href="classGdk_1_1Display.html" title="Gdk::Display object&#39;s purpose is two fold: To grab/ungrab keyboard focus and...">Gdk::Display</a> associated with <em>clipboard</em>. <p>
408
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The <a class="el" href="classGdk_1_1Display.html" title="Gdk::Display object&#39;s purpose is two fold: To grab/ungrab keyboard focus and...">Gdk::Display</a> associated with <em>clipboard</em> </dd></dl>
409
 
<dl compact><dt><b><a class="el" href="since_2_2.html#_since_2_2000095">Since gtkmm 2.2:</a></b></dt><dd></dd></dl>
 
358
<p>Gets the <a class="el" href="classGdk_1_1Display.html" title="Gdk::Display object&#39;s purpose is two fold: To grab/ungrab keyboard focus and...">Gdk::Display</a> associated with <em>clipboard</em>. </p>
 
359
<dl class="return"><dt><b>Returns:</b></dt><dd>The <a class="el" href="classGdk_1_1Display.html" title="Gdk::Display object&#39;s purpose is two fold: To grab/ungrab keyboard focus and...">Gdk::Display</a> associated with <em>clipboard</em> </dd></dl>
 
360
<dl class="since_2_2"><dt><b><a class="el" href="since_2_2.html#_since_2_2000095">Since gtkmm 2.2:</a></b></dt><dd></dd></dl>
410
361
 
411
362
</div>
412
 
</div><p>
413
 
<a class="anchor" name="696d084d1ef3c7cbe298b4e78e8ea167"></a><!-- doxytag: member="Gtk::Clipboard::get_display" ref="696d084d1ef3c7cbe298b4e78e8ea167" args="()" -->
 
363
</div>
 
364
<a class="anchor" id="a696d084d1ef3c7cbe298b4e78e8ea167"></a><!-- doxytag: member="Gtk::Clipboard::get_display" ref="a696d084d1ef3c7cbe298b4e78e8ea167" args="()" -->
414
365
<div class="memitem">
415
366
<div class="memproto">
416
367
      <table class="memname">
417
368
        <tr>
418
369
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGdk_1_1Display.html">Gdk::Display</a>&gt; Gtk::Clipboard::get_display </td>
419
370
          <td>(</td>
420
 
          <td class="paramname"> </td>
 
371
          <td class="paramname"></td>
421
372
          <td>&#160;)&#160;</td>
422
373
          <td></td>
423
374
        </tr>
425
376
</div>
426
377
<div class="memdoc">
427
378
 
428
 
<p>
429
 
Gets the <a class="el" href="classGdk_1_1Display.html" title="Gdk::Display object&#39;s purpose is two fold: To grab/ungrab keyboard focus and...">Gdk::Display</a> associated with <em>clipboard</em>. <p>
430
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The <a class="el" href="classGdk_1_1Display.html" title="Gdk::Display object&#39;s purpose is two fold: To grab/ungrab keyboard focus and...">Gdk::Display</a> associated with <em>clipboard</em> </dd></dl>
431
 
<dl compact><dt><b><a class="el" href="since_2_2.html#_since_2_2000094">Since gtkmm 2.2:</a></b></dt><dd></dd></dl>
 
379
<p>Gets the <a class="el" href="classGdk_1_1Display.html" title="Gdk::Display object&#39;s purpose is two fold: To grab/ungrab keyboard focus and...">Gdk::Display</a> associated with <em>clipboard</em>. </p>
 
380
<dl class="return"><dt><b>Returns:</b></dt><dd>The <a class="el" href="classGdk_1_1Display.html" title="Gdk::Display object&#39;s purpose is two fold: To grab/ungrab keyboard focus and...">Gdk::Display</a> associated with <em>clipboard</em> </dd></dl>
 
381
<dl class="since_2_2"><dt><b><a class="el" href="since_2_2.html#_since_2_2000094">Since gtkmm 2.2:</a></b></dt><dd></dd></dl>
432
382
 
433
383
</div>
434
 
</div><p>
435
 
<a class="anchor" name="880ad980703636e3aed1f25c066ebbc9"></a><!-- doxytag: member="Gtk::Clipboard::get_for_display" ref="880ad980703636e3aed1f25c066ebbc9" args="(const Glib::RefPtr&lt; Gdk::Display &gt; &amp;display, GdkAtom selection=GDK_SELECTION_CLIPBOARD)" -->
 
384
</div>
 
385
<a class="anchor" id="a880ad980703636e3aed1f25c066ebbc9"></a><!-- doxytag: member="Gtk::Clipboard::get_for_display" ref="a880ad980703636e3aed1f25c066ebbc9" args="(const Glib::RefPtr&lt; Gdk::Display &gt; &amp;display, GdkAtom selection=GDK_SELECTION_CLIPBOARD)" -->
436
386
<div class="memitem">
437
387
<div class="memproto">
438
388
      <table class="memname">
457
407
</div>
458
408
<div class="memdoc">
459
409
 
460
 
<p>
461
 
Return value: the appropriate clipboard object. <p>
462
 
If no <dl compact><dt><b>Parameters:</b></dt><dd>
 
410
<p>Return value: the appropriate clipboard object. </p>
 
411
<p>If no </p>
 
412
<dl><dt><b>Parameters:</b></dt><dd>
463
413
  <table border="0" cellspacing="2" cellpadding="0">
464
414
    <tr><td valign="top"></td><td valign="top"><em>display</em>&#160;</td><td>The display for which the clipboard is to be retrieved or created. </td></tr>
465
415
    <tr><td valign="top"></td><td valign="top"><em>selection</em>&#160;</td><td>A Gdk::Atom which identifies the clipboard to use. </td></tr>
466
416
  </table>
 
417
  </dd>
467
418
</dl>
468
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The appropriate clipboard object. If no clipboard already exists, a new one will be created. Once a clipboard object has been created, it is persistent and, since it is owned by GTK+, must not be freed or unrefd.</dd></dl>
469
 
<dl compact><dt><b><a class="el" href="since_2_2.html#_since_2_2000093">Since gtkmm 2.2:</a></b></dt><dd></dd></dl>
 
419
<dl class="return"><dt><b>Returns:</b></dt><dd>The appropriate clipboard object. If no clipboard already exists, a new one will be created. Once a clipboard object has been created, it is persistent and, since it is owned by GTK+, must not be freed or unrefd.</dd></dl>
 
420
<dl class="since_2_2"><dt><b><a class="el" href="since_2_2.html#_since_2_2000093">Since gtkmm 2.2:</a></b></dt><dd></dd></dl>
470
421
 
471
422
</div>
472
 
</div><p>
473
 
<a class="anchor" name="6c68c91213f935715c5c9b1a612d98f6"></a><!-- doxytag: member="Gtk::Clipboard::get_owner" ref="6c68c91213f935715c5c9b1a612d98f6" args="() const " -->
 
423
</div>
 
424
<a class="anchor" id="a6c68c91213f935715c5c9b1a612d98f6"></a><!-- doxytag: member="Gtk::Clipboard::get_owner" ref="a6c68c91213f935715c5c9b1a612d98f6" args="() const " -->
474
425
<div class="memitem">
475
426
<div class="memproto">
476
427
      <table class="memname">
477
428
        <tr>
478
429
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html">Glib::Object</a>&gt; Gtk::Clipboard::get_owner </td>
479
430
          <td>(</td>
480
 
          <td class="paramname"> </td>
 
431
          <td class="paramname"></td>
481
432
          <td>&#160;)&#160;</td>
482
433
          <td> const</td>
483
434
        </tr>
485
436
</div>
486
437
<div class="memdoc">
487
438
 
488
 
<p>
489
 
If the clipboard contents callbacks were set with set_with_owner(), and the set_with_data() or <a class="el" href="classGtk_1_1Clipboard.html#bf8118f4098f9565f1d85d8d88409a1c" title="Clears the contents of the clipboard.">clear()</a> has not subsequently called, returns the owner set by set_with_owner(). <p>
490
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The owner of the clipboard, if any; otherwise <code>0</code>. </dd></dl>
 
439
<p>If the clipboard contents callbacks were set with set_with_owner(), and the set_with_data() or <a class="el" href="classGtk_1_1Clipboard.html#abf8118f4098f9565f1d85d8d88409a1c" title="Clears the contents of the clipboard.">clear()</a> has not subsequently called, returns the owner set by set_with_owner(). </p>
 
440
<dl class="return"><dt><b>Returns:</b></dt><dd>The owner of the clipboard, if any; otherwise <code>0</code>. </dd></dl>
491
441
 
492
442
</div>
493
 
</div><p>
494
 
<a class="anchor" name="77714f58487355b0f34ad154b1a99138"></a><!-- doxytag: member="Gtk::Clipboard::get_owner" ref="77714f58487355b0f34ad154b1a99138" args="()" -->
 
443
</div>
 
444
<a class="anchor" id="a77714f58487355b0f34ad154b1a99138"></a><!-- doxytag: member="Gtk::Clipboard::get_owner" ref="a77714f58487355b0f34ad154b1a99138" args="()" -->
495
445
<div class="memitem">
496
446
<div class="memproto">
497
447
      <table class="memname">
498
448
        <tr>
499
449
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html">Glib::Object</a>&gt; Gtk::Clipboard::get_owner </td>
500
450
          <td>(</td>
501
 
          <td class="paramname"> </td>
 
451
          <td class="paramname"></td>
502
452
          <td>&#160;)&#160;</td>
503
453
          <td></td>
504
454
        </tr>
506
456
</div>
507
457
<div class="memdoc">
508
458
 
509
 
<p>
510
 
If the clipboard contents callbacks were set with set_with_owner(), and the set_with_data() or <a class="el" href="classGtk_1_1Clipboard.html#bf8118f4098f9565f1d85d8d88409a1c" title="Clears the contents of the clipboard.">clear()</a> has not subsequently called, returns the owner set by set_with_owner(). <p>
511
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The owner of the clipboard, if any; otherwise <code>0</code>. </dd></dl>
 
459
<p>If the clipboard contents callbacks were set with set_with_owner(), and the set_with_data() or <a class="el" href="classGtk_1_1Clipboard.html#abf8118f4098f9565f1d85d8d88409a1c" title="Clears the contents of the clipboard.">clear()</a> has not subsequently called, returns the owner set by set_with_owner(). </p>
 
460
<dl class="return"><dt><b>Returns:</b></dt><dd>The owner of the clipboard, if any; otherwise <code>0</code>. </dd></dl>
512
461
 
513
462
</div>
514
 
</div><p>
515
 
<a class="anchor" name="307fb72e6fd57d378a981ef0604e4568"></a><!-- doxytag: member="Gtk::Clipboard::gobj" ref="307fb72e6fd57d378a981ef0604e4568" args="() const " -->
 
463
</div>
 
464
<a class="anchor" id="a307fb72e6fd57d378a981ef0604e4568"></a><!-- doxytag: member="Gtk::Clipboard::gobj" ref="a307fb72e6fd57d378a981ef0604e4568" args="() const " -->
516
465
<div class="memitem">
517
466
<div class="memproto">
518
467
      <table class="memname">
519
468
        <tr>
520
469
          <td class="memname">const GtkClipboard* Gtk::Clipboard::gobj </td>
521
470
          <td>(</td>
522
 
          <td class="paramname"> </td>
 
471
          <td class="paramname"></td>
523
472
          <td>&#160;)&#160;</td>
524
473
          <td> const<code> [inline]</code></td>
525
474
        </tr>
527
476
</div>
528
477
<div class="memdoc">
529
478
 
530
 
<p>
531
 
Provides access to the underlying C GObject. <p>
532
 
 
533
 
<p>Reimplemented from <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ObjectBase.html#778a94181132976bbfb0519793f3b32e">Glib::ObjectBase</a>.</p>
534
 
 
535
 
</div>
536
 
</div><p>
537
 
<a class="anchor" name="eb465195991ea12f2ee81733a1fa03b0"></a><!-- doxytag: member="Gtk::Clipboard::gobj" ref="eb465195991ea12f2ee81733a1fa03b0" args="()" -->
 
479
<p>Provides access to the underlying C GObject. </p>
 
480
 
 
481
<p>Reimplemented from <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ObjectBase.html#a778a94181132976bbfb0519793f3b32e">Glib::ObjectBase</a>.</p>
 
482
 
 
483
</div>
 
484
</div>
 
485
<a class="anchor" id="aeb465195991ea12f2ee81733a1fa03b0"></a><!-- doxytag: member="Gtk::Clipboard::gobj" ref="aeb465195991ea12f2ee81733a1fa03b0" args="()" -->
538
486
<div class="memitem">
539
487
<div class="memproto">
540
488
      <table class="memname">
541
489
        <tr>
542
490
          <td class="memname">GtkClipboard* Gtk::Clipboard::gobj </td>
543
491
          <td>(</td>
544
 
          <td class="paramname"> </td>
 
492
          <td class="paramname"></td>
545
493
          <td>&#160;)&#160;</td>
546
494
          <td><code> [inline]</code></td>
547
495
        </tr>
549
497
</div>
550
498
<div class="memdoc">
551
499
 
552
 
<p>
553
 
Provides access to the underlying C GObject. <p>
554
 
 
555
 
<p>Reimplemented from <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ObjectBase.html#4c6efc18be8cb9c56e58fc0bd20fafbe">Glib::ObjectBase</a>.</p>
556
 
 
557
 
</div>
558
 
</div><p>
559
 
<a class="anchor" name="487b4d31a656a355286187b216d643cd"></a><!-- doxytag: member="Gtk::Clipboard::gobj_copy" ref="487b4d31a656a355286187b216d643cd" args="()" -->
 
500
<p>Provides access to the underlying C GObject. </p>
 
501
 
 
502
<p>Reimplemented from <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ObjectBase.html#a4c6efc18be8cb9c56e58fc0bd20fafbe">Glib::ObjectBase</a>.</p>
 
503
 
 
504
</div>
 
505
</div>
 
506
<a class="anchor" id="a487b4d31a656a355286187b216d643cd"></a><!-- doxytag: member="Gtk::Clipboard::gobj_copy" ref="a487b4d31a656a355286187b216d643cd" args="()" -->
560
507
<div class="memitem">
561
508
<div class="memproto">
562
509
      <table class="memname">
563
510
        <tr>
564
511
          <td class="memname">GtkClipboard* Gtk::Clipboard::gobj_copy </td>
565
512
          <td>(</td>
566
 
          <td class="paramname"> </td>
 
513
          <td class="paramname"></td>
567
514
          <td>&#160;)&#160;</td>
568
515
          <td></td>
569
516
        </tr>
571
518
</div>
572
519
<div class="memdoc">
573
520
 
574
 
<p>
575
 
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. <p>
 
521
<p>Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. </p>
576
522
 
577
523
</div>
578
 
</div><p>
579
 
<a class="anchor" name="7b89b96071d9d6019eb35203538ac6a6"></a><!-- doxytag: member="Gtk::Clipboard::request_contents" ref="7b89b96071d9d6019eb35203538ac6a6" args="(const Glib::ustring &amp;target, const SlotReceived &amp;slot)" -->
 
524
</div>
 
525
<a class="anchor" id="a7b89b96071d9d6019eb35203538ac6a6"></a><!-- doxytag: member="Gtk::Clipboard::request_contents" ref="a7b89b96071d9d6019eb35203538ac6a6" args="(const Glib::ustring &amp;target, const SlotReceived &amp;slot)" -->
580
526
<div class="memitem">
581
527
<div class="memproto">
582
528
      <table class="memname">
601
547
</div>
602
548
<div class="memdoc">
603
549
 
604
 
<p>
605
 
Requests the contents of clipboard as the given target. <p>
606
 
When the results of the result are later received the supplied callback will be called.<p>
607
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
550
<p>Requests the contents of clipboard as the given target. </p>
 
551
<p>When the results of the result are later received the supplied callback will be called.</p>
 
552
<dl><dt><b>Parameters:</b></dt><dd>
608
553
  <table border="0" cellspacing="2" cellpadding="0">
609
554
    <tr><td valign="top"></td><td valign="top"><em>target</em>&#160;</td><td>The form into which the clipboard owner should convert the selection. </td></tr>
610
555
    <tr><td valign="top"></td><td valign="top"><em>slot</em>&#160;</td><td>A function to call when the results are received (or the retrieval fails). If the retrieval fails the length field of selection_data will be negative. </td></tr>
611
556
  </table>
 
557
  </dd>
612
558
</dl>
613
559
 
614
560
</div>
615
 
</div><p>
616
 
<a class="anchor" name="cf9daec8f085ea57218a0ced6bc9e949"></a><!-- doxytag: member="Gtk::Clipboard::request_image" ref="cf9daec8f085ea57218a0ced6bc9e949" args="(const SlotImageReceived &amp;slot)" -->
 
561
</div>
 
562
<a class="anchor" id="acf9daec8f085ea57218a0ced6bc9e949"></a><!-- doxytag: member="Gtk::Clipboard::request_image" ref="acf9daec8f085ea57218a0ced6bc9e949" args="(const SlotImageReceived &amp;slot)" -->
617
563
<div class="memitem">
618
564
<div class="memproto">
619
565
      <table class="memname">
621
567
          <td class="memname">void Gtk::Clipboard::request_image </td>
622
568
          <td>(</td>
623
569
          <td class="paramtype">const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotImageReceived</a> &amp;&#160;</td>
624
 
          <td class="paramname"> <em>slot</em> </td>
 
570
          <td class="paramname"> <em>slot</em></td>
625
571
          <td>&#160;)&#160;</td>
626
572
          <td></td>
627
573
        </tr>
629
575
</div>
630
576
<div class="memdoc">
631
577
 
632
 
<p>
633
 
Requests the contents of the clipboard as image. <p>
634
 
When the image is later received, it will be converted to a <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a>. This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.<p>
635
 
The pixbuf parameter to slot will contain the resulting pixbuf if the request succeeded, or will be empty if it failed. This could happen for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into image form.<p>
636
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
578
<p>Requests the contents of the clipboard as image. </p>
 
579
<p>When the image is later received, it will be converted to a <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a>. This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.</p>
 
580
<p>The pixbuf parameter to slot will contain the resulting pixbuf if the request succeeded, or will be empty if it failed. This could happen for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into image form.</p>
 
581
<dl><dt><b>Parameters:</b></dt><dd>
637
582
  <table border="0" cellspacing="2" cellpadding="0">
638
583
    <tr><td valign="top"></td><td valign="top"><em>slot,:</em>&#160;</td><td>a function to call when the text is received, or the retrieval fails. (It will always be called one way or the other.) </td></tr>
639
584
  </table>
 
585
  </dd>
640
586
</dl>
641
587
 
642
588
</div>
643
 
</div><p>
644
 
<a class="anchor" name="2fe9763417d17a586bcae713567800d8"></a><!-- doxytag: member="Gtk::Clipboard::request_rich_text" ref="2fe9763417d17a586bcae713567800d8" args="(const Glib::RefPtr&lt; TextBuffer &gt; &amp;buffer, const SlotRichTextReceived &amp;slot)" -->
 
589
</div>
 
590
<a class="anchor" id="a2fe9763417d17a586bcae713567800d8"></a><!-- doxytag: member="Gtk::Clipboard::request_rich_text" ref="a2fe9763417d17a586bcae713567800d8" args="(const Glib::RefPtr&lt; TextBuffer &gt; &amp;buffer, const SlotRichTextReceived &amp;slot)" -->
645
591
<div class="memitem">
646
592
<div class="memproto">
647
593
      <table class="memname">
666
612
</div>
667
613
<div class="memdoc">
668
614
 
669
 
<p>
670
 
Requests the contents of the clipboard as rich text. <p>
671
 
When the rich text is later received, callback will be called.<p>
672
 
The text parameter to the callback will contain the resulting rich text if the request succeeded, or an empty string if it failed. This function can fail for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into rich text form.<p>
673
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
615
<p>Requests the contents of the clipboard as rich text. </p>
 
616
<p>When the rich text is later received, callback will be called.</p>
 
617
<p>The text parameter to the callback will contain the resulting rich text if the request succeeded, or an empty string if it failed. This function can fail for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into rich text form.</p>
 
618
<dl><dt><b>Parameters:</b></dt><dd>
674
619
  <table border="0" cellspacing="2" cellpadding="0">
675
620
    <tr><td valign="top"></td><td valign="top"><em>slot,:</em>&#160;</td><td>a function to call when the text is received, or the retrieval fails. (It will always be called one way or the other.) </td></tr>
676
621
  </table>
 
622
  </dd>
677
623
</dl>
678
624
 
679
625
</div>
680
 
</div><p>
681
 
<a class="anchor" name="e3be3a0d85849117a284f8a1cbfdb98e"></a><!-- doxytag: member="Gtk::Clipboard::request_targets" ref="e3be3a0d85849117a284f8a1cbfdb98e" args="(const SlotTargetsReceived &amp;slot)" -->
 
626
</div>
 
627
<a class="anchor" id="ae3be3a0d85849117a284f8a1cbfdb98e"></a><!-- doxytag: member="Gtk::Clipboard::request_targets" ref="ae3be3a0d85849117a284f8a1cbfdb98e" args="(const SlotTargetsReceived &amp;slot)" -->
682
628
<div class="memitem">
683
629
<div class="memproto">
684
630
      <table class="memname">
686
632
          <td class="memname">void Gtk::Clipboard::request_targets </td>
687
633
          <td>(</td>
688
634
          <td class="paramtype">const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotTargetsReceived</a> &amp;&#160;</td>
689
 
          <td class="paramname"> <em>slot</em> </td>
 
635
          <td class="paramname"> <em>slot</em></td>
690
636
          <td>&#160;)&#160;</td>
691
637
          <td></td>
692
638
        </tr>
694
640
</div>
695
641
<div class="memdoc">
696
642
 
697
 
<p>
698
 
Requests the contents of the clipboard as list of supported targets. <p>
699
 
When the list is later received, callback will be called.<p>
700
 
The targets parameter to slot will contain the resulting targets if the request succeeded.<p>
701
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
643
<p>Requests the contents of the clipboard as list of supported targets. </p>
 
644
<p>When the list is later received, callback will be called.</p>
 
645
<p>The targets parameter to slot will contain the resulting targets if the request succeeded.</p>
 
646
<dl><dt><b>Parameters:</b></dt><dd>
702
647
  <table border="0" cellspacing="2" cellpadding="0">
703
 
    <tr><td valign="top"></td><td valign="top"><em>slot</em>&#160;</td><td>a function to call when the targets are received, or the retrieval fails. (It will always be called one way or the other.) Remember that <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/group__ContHandles.html#g8e243b697be740f5f7d4b578ae50db41">Glib::StringArrayHandle</a> is an intermediate type, so you should convert it to a standard C++ container.</td></tr>
 
648
    <tr><td valign="top"></td><td valign="top"><em>slot</em>&#160;</td><td>a function to call when the targets are received, or the retrieval fails. (It will always be called one way or the other.) Remember that <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/group__ContHandles.html#ga8e243b697be740f5f7d4b578ae50db41">Glib::StringArrayHandle</a> is an intermediate type, so you should convert it to a standard C++ container.</td></tr>
704
649
  </table>
 
650
  </dd>
705
651
</dl>
706
 
<dl compact><dt><b><a class="el" href="since_2_4.html#_since_2_4000061">Since gtkmm 2.4:</a></b></dt><dd></dd></dl>
 
652
<dl class="since_2_4"><dt><b><a class="el" href="since_2_4.html#_since_2_4000061">Since gtkmm 2.4:</a></b></dt><dd></dd></dl>
707
653
 
708
654
</div>
709
 
</div><p>
710
 
<a class="anchor" name="922ca2e0595b10ec7bcad59632b00f34"></a><!-- doxytag: member="Gtk::Clipboard::request_text" ref="922ca2e0595b10ec7bcad59632b00f34" args="(const SlotTextReceived &amp;slot)" -->
 
655
</div>
 
656
<a class="anchor" id="a922ca2e0595b10ec7bcad59632b00f34"></a><!-- doxytag: member="Gtk::Clipboard::request_text" ref="a922ca2e0595b10ec7bcad59632b00f34" args="(const SlotTextReceived &amp;slot)" -->
711
657
<div class="memitem">
712
658
<div class="memproto">
713
659
      <table class="memname">
715
661
          <td class="memname">void Gtk::Clipboard::request_text </td>
716
662
          <td>(</td>
717
663
          <td class="paramtype">const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotTextReceived</a> &amp;&#160;</td>
718
 
          <td class="paramname"> <em>slot</em> </td>
 
664
          <td class="paramname"> <em>slot</em></td>
719
665
          <td>&#160;)&#160;</td>
720
666
          <td></td>
721
667
        </tr>
723
669
</div>
724
670
<div class="memdoc">
725
671
 
726
 
<p>
727
 
Requests the contents of the clipboard as text. <p>
728
 
When the text is later received, it will be converted to UTF-8 if necessary, and slot will be called.<p>
729
 
The text parameter to slot will contain the resulting text if the request succeeded, or will be empty if it failed. This could happen for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into text form.<p>
730
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
672
<p>Requests the contents of the clipboard as text. </p>
 
673
<p>When the text is later received, it will be converted to UTF-8 if necessary, and slot will be called.</p>
 
674
<p>The text parameter to slot will contain the resulting text if the request succeeded, or will be empty if it failed. This could happen for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into text form.</p>
 
675
<dl><dt><b>Parameters:</b></dt><dd>
731
676
  <table border="0" cellspacing="2" cellpadding="0">
732
677
    <tr><td valign="top"></td><td valign="top"><em>slot,:</em>&#160;</td><td>a function to call when the text is received, or the retrieval fails. (It will always be called one way or the other.) </td></tr>
733
678
  </table>
 
679
  </dd>
734
680
</dl>
735
681
 
736
682
</div>
737
 
</div><p>
738
 
<a class="anchor" name="482e597790498098d3d42751267418bc"></a><!-- doxytag: member="Gtk::Clipboard::request_uris" ref="482e597790498098d3d42751267418bc" args="(const SlotUrisReceived &amp;slot)" -->
 
683
</div>
 
684
<a class="anchor" id="a482e597790498098d3d42751267418bc"></a><!-- doxytag: member="Gtk::Clipboard::request_uris" ref="a482e597790498098d3d42751267418bc" args="(const SlotUrisReceived &amp;slot)" -->
739
685
<div class="memitem">
740
686
<div class="memproto">
741
687
      <table class="memname">
743
689
          <td class="memname">void Gtk::Clipboard::request_uris </td>
744
690
          <td>(</td>
745
691
          <td class="paramtype">const <a class="elRef" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/classsigc_1_1slot.html">SlotUrisReceived</a> &amp;&#160;</td>
746
 
          <td class="paramname"> <em>slot</em> </td>
 
692
          <td class="paramname"> <em>slot</em></td>
747
693
          <td>&#160;)&#160;</td>
748
694
          <td></td>
749
695
        </tr>
751
697
</div>
752
698
<div class="memdoc">
753
699
 
754
 
<p>
755
 
Requests the contents of the clipboard as URIs. <p>
756
 
When the URIs are later received <em>slot</em> will be called.<p>
757
 
The uris parameter to <em>slot</em> will contain the resulting array of URIs if the request succeeded, or an empty list if it failed. This could happen for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into URI form.<p>
758
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
700
<p>Requests the contents of the clipboard as URIs. </p>
 
701
<p>When the URIs are later received <em>slot</em> will be called.</p>
 
702
<p>The uris parameter to <em>slot</em> will contain the resulting array of URIs if the request succeeded, or an empty list if it failed. This could happen for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into URI form.</p>
 
703
<dl><dt><b>Parameters:</b></dt><dd>
759
704
  <table border="0" cellspacing="2" cellpadding="0">
760
705
    <tr><td valign="top"></td><td valign="top"><em>slot</em>&#160;</td><td>A slot to call when the URIs are received, or the retrieval fails. (It will always be called one way or the other.)</td></tr>
761
706
  </table>
 
707
  </dd>
762
708
</dl>
763
 
<dl compact><dt><b><a class="el" href="since_2_14.html#_since_2_14000038">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
 
709
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000038">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
764
710
 
765
711
</div>
766
 
</div><p>
767
 
<a class="anchor" name="6eed4302482ee376daf47bf5fcc42605"></a><!-- doxytag: member="Gtk::Clipboard::set" ref="6eed4302482ee376daf47bf5fcc42605" args="(const ArrayHandle_TargetEntry &amp;targets, const SlotGet &amp;slot_get, const SlotClear &amp;slot_clear)" -->
 
712
</div>
 
713
<a class="anchor" id="a6eed4302482ee376daf47bf5fcc42605"></a><!-- doxytag: member="Gtk::Clipboard::set" ref="a6eed4302482ee376daf47bf5fcc42605" args="(const ArrayHandle_TargetEntry &amp;targets, const SlotGet &amp;slot_get, const SlotClear &amp;slot_clear)" -->
768
714
<div class="memitem">
769
715
<div class="memproto">
770
716
      <table class="memname">
795
741
</div>
796
742
<div class="memdoc">
797
743
 
798
 
<p>
799
 
Virtually sets the contents of the specified clipboard by providing a list of supported formats for the clipboard data and a function to call to get the actual data when it is requested. <p>
800
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
744
<p>Virtually sets the contents of the specified clipboard by providing a list of supported formats for the clipboard data and a function to call to get the actual data when it is requested. </p>
 
745
<dl><dt><b>Parameters:</b></dt><dd>
801
746
  <table border="0" cellspacing="2" cellpadding="0">
802
747
    <tr><td valign="top"></td><td valign="top"><em>targets</em>&#160;</td><td>Information about the available forms for the clipboard data. </td></tr>
803
748
    <tr><td valign="top"></td><td valign="top"><em>slot_get</em>&#160;</td><td>method to call to get the actual clipboard data. </td></tr>
804
749
    <tr><td valign="top"></td><td valign="top"><em>slot_clear</em>&#160;</td><td>When the clipboard contents are set again, this method will be called, and slot_get will not be subsequently called.</td></tr>
805
750
  </table>
 
751
  </dd>
806
752
</dl>
807
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>true if setting the clipboard data succeeded. If setting the clipboard data failed then the provided callback methods will be ignored. </dd></dl>
 
753
<dl class="return"><dt><b>Returns:</b></dt><dd>true if setting the clipboard data succeeded. If setting the clipboard data failed then the provided callback methods will be ignored. </dd></dl>
808
754
 
809
755
</div>
810
 
</div><p>
811
 
<a class="anchor" name="5f2fc04281ab4e2370098bfeb10108ac"></a><!-- doxytag: member="Gtk::Clipboard::set_can_store" ref="5f2fc04281ab4e2370098bfeb10108ac" args="()" -->
 
756
</div>
 
757
<a class="anchor" id="a5f2fc04281ab4e2370098bfeb10108ac"></a><!-- doxytag: member="Gtk::Clipboard::set_can_store" ref="a5f2fc04281ab4e2370098bfeb10108ac" args="()" -->
812
758
<div class="memitem">
813
759
<div class="memproto">
814
760
      <table class="memname">
815
761
        <tr>
816
762
          <td class="memname">void Gtk::Clipboard::set_can_store </td>
817
763
          <td>(</td>
818
 
          <td class="paramname"> </td>
 
764
          <td class="paramname"></td>
819
765
          <td>&#160;)&#160;</td>
820
766
          <td></td>
821
767
        </tr>
823
769
</div>
824
770
<div class="memdoc">
825
771
 
826
 
<p>
827
 
Hints that all forms of clipboard data should be stored somewhere when the application exits or when <a class="el" href="classGtk_1_1Clipboard.html#47f0293ba7f80821537797537d5b6408" title="Stores the current clipboard data somewhere so that it will stay around after the...">store()</a> is called. <p>
828
 
This value is reset when the clipboard owner changes. Where the clipboard data is stored is platform dependent, see <a class="el" href="classGdk_1_1Display.html#0d31c8b4dfc1aca3b747497bfa2e60de" title="Issues a request to the clipboard manager to store the clipboard data, saving all...">Gdk::Display::store_clipboard()</a> for more information. </div>
829
 
</div><p>
830
 
<a class="anchor" name="89ddaa80ac9aa1664aff952d4f25630f"></a><!-- doxytag: member="Gtk::Clipboard::set_can_store" ref="89ddaa80ac9aa1664aff952d4f25630f" args="(const ArrayHandle_TargetEntry &amp;targets)" -->
 
772
<p>Hints that all forms of clipboard data should be stored somewhere when the application exits or when <a class="el" href="classGtk_1_1Clipboard.html#a47f0293ba7f80821537797537d5b6408" title="Stores the current clipboard data somewhere so that it will stay around after the...">store()</a> is called. </p>
 
773
<p>This value is reset when the clipboard owner changes. Where the clipboard data is stored is platform dependent, see <a class="el" href="classGdk_1_1Display.html#a0d31c8b4dfc1aca3b747497bfa2e60de" title="Issues a request to the clipboard manager to store the clipboard data, saving all...">Gdk::Display::store_clipboard()</a> for more information. </p>
 
774
 
 
775
</div>
 
776
</div>
 
777
<a class="anchor" id="a89ddaa80ac9aa1664aff952d4f25630f"></a><!-- doxytag: member="Gtk::Clipboard::set_can_store" ref="a89ddaa80ac9aa1664aff952d4f25630f" args="(const ArrayHandle_TargetEntry &amp;targets)" -->
831
778
<div class="memitem">
832
779
<div class="memproto">
833
780
      <table class="memname">
835
782
          <td class="memname">void Gtk::Clipboard::set_can_store </td>
836
783
          <td>(</td>
837
784
          <td class="paramtype">const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">ArrayHandle_TargetEntry</a> &amp;&#160;</td>
838
 
          <td class="paramname"> <em>targets</em> </td>
 
785
          <td class="paramname"> <em>targets</em></td>
839
786
          <td>&#160;)&#160;</td>
840
787
          <td></td>
841
788
        </tr>
843
790
</div>
844
791
<div class="memdoc">
845
792
 
846
 
<p>
847
 
Hints that the clipboard data should be stored somewhere when the application exits or when <a class="el" href="classGtk_1_1Clipboard.html#47f0293ba7f80821537797537d5b6408" title="Stores the current clipboard data somewhere so that it will stay around after the...">store()</a> is called. <p>
848
 
This value is reset when the clipboard owner changes. Where the clipboard data is stored is platform dependent, see <a class="el" href="classGdk_1_1Display.html#0d31c8b4dfc1aca3b747497bfa2e60de" title="Issues a request to the clipboard manager to store the clipboard data, saving all...">Gdk::Display::store_clipboard()</a> for more information.<p>
849
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
793
<p>Hints that the clipboard data should be stored somewhere when the application exits or when <a class="el" href="classGtk_1_1Clipboard.html#a47f0293ba7f80821537797537d5b6408" title="Stores the current clipboard data somewhere so that it will stay around after the...">store()</a> is called. </p>
 
794
<p>This value is reset when the clipboard owner changes. Where the clipboard data is stored is platform dependent, see <a class="el" href="classGdk_1_1Display.html#a0d31c8b4dfc1aca3b747497bfa2e60de" title="Issues a request to the clipboard manager to store the clipboard data, saving all...">Gdk::Display::store_clipboard()</a> for more information.</p>
 
795
<dl><dt><b>Parameters:</b></dt><dd>
850
796
  <table border="0" cellspacing="2" cellpadding="0">
851
797
    <tr><td valign="top"></td><td valign="top"><em>targets</em>&#160;</td><td>Array containing information about which forms should be stored. </td></tr>
852
798
  </table>
 
799
  </dd>
853
800
</dl>
854
801
 
855
802
</div>
856
 
</div><p>
857
 
<a class="anchor" name="49841702b88e06547f48b7f0b9c1fe5d"></a><!-- doxytag: member="Gtk::Clipboard::set_image" ref="49841702b88e06547f48b7f0b9c1fe5d" args="(const Glib::RefPtr&lt; Gdk::Pixbuf &gt; &amp;pixbuf)" -->
 
803
</div>
 
804
<a class="anchor" id="a49841702b88e06547f48b7f0b9c1fe5d"></a><!-- doxytag: member="Gtk::Clipboard::set_image" ref="a49841702b88e06547f48b7f0b9c1fe5d" args="(const Glib::RefPtr&lt; Gdk::Pixbuf &gt; &amp;pixbuf)" -->
858
805
<div class="memitem">
859
806
<div class="memproto">
860
807
      <table class="memname">
862
809
          <td class="memname">void Gtk::Clipboard::set_image </td>
863
810
          <td>(</td>
864
811
          <td class="paramtype">const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a> &gt;&amp;&#160;</td>
865
 
          <td class="paramname"> <em>pixbuf</em> </td>
 
812
          <td class="paramname"> <em>pixbuf</em></td>
866
813
          <td>&#160;)&#160;</td>
867
814
          <td></td>
868
815
        </tr>
870
817
</div>
871
818
<div class="memdoc">
872
819
 
873
 
<p>
874
 
Sets the contents of the clipboard to the given <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a>. <p>
875
 
GTK+ will take responsibility for responding for requests for the image, and for converting the image into the requested format.<p>
876
 
<dl compact><dt><b><a class="el" href="since_2_6.html#_since_2_6000057">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
877
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
820
<p>Sets the contents of the clipboard to the given <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a>. </p>
 
821
<p>GTK+ will take responsibility for responding for requests for the image, and for converting the image into the requested format.</p>
 
822
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000056">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
 
823
<dl><dt><b>Parameters:</b></dt><dd>
878
824
  <table border="0" cellspacing="2" cellpadding="0">
879
825
    <tr><td valign="top"></td><td valign="top"><em>pixbuf</em>&#160;</td><td>A <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a>. </td></tr>
880
826
  </table>
 
827
  </dd>
881
828
</dl>
882
829
 
883
830
</div>
884
 
</div><p>
885
 
<a class="anchor" name="aeee306b25ea1e0206e3ffb30af93c32"></a><!-- doxytag: member="Gtk::Clipboard::set_text" ref="aeee306b25ea1e0206e3ffb30af93c32" args="(const Glib::ustring &amp;text)" -->
 
831
</div>
 
832
<a class="anchor" id="aaeee306b25ea1e0206e3ffb30af93c32"></a><!-- doxytag: member="Gtk::Clipboard::set_text" ref="aaeee306b25ea1e0206e3ffb30af93c32" args="(const Glib::ustring &amp;text)" -->
886
833
<div class="memitem">
887
834
<div class="memproto">
888
835
      <table class="memname">
890
837
          <td class="memname">void Gtk::Clipboard::set_text </td>
891
838
          <td>(</td>
892
839
          <td class="paramtype">const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
893
 
          <td class="paramname"> <em>text</em> </td>
 
840
          <td class="paramname"> <em>text</em></td>
894
841
          <td>&#160;)&#160;</td>
895
842
          <td></td>
896
843
        </tr>
898
845
</div>
899
846
<div class="memdoc">
900
847
 
901
 
<p>
902
 
Sets the contents of the clipboard to the given UTF-8 string. <p>
903
 
GTK+ will make a copy of the text and take responsibility for responding for requests for the text, and for converting the text into the requested format.<p>
904
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
848
<p>Sets the contents of the clipboard to the given UTF-8 string. </p>
 
849
<p>GTK+ will make a copy of the text and take responsibility for responding for requests for the text, and for converting the text into the requested format.</p>
 
850
<dl><dt><b>Parameters:</b></dt><dd>
905
851
  <table border="0" cellspacing="2" cellpadding="0">
906
852
    <tr><td valign="top"></td><td valign="top"><em>text</em>&#160;</td><td>A UTF-8 string. </td></tr>
907
853
  </table>
 
854
  </dd>
908
855
</dl>
909
856
 
910
857
</div>
911
 
</div><p>
912
 
<a class="anchor" name="3d19cb78841fd7e73fdddca0daeac22b"></a><!-- doxytag: member="Gtk::Clipboard::signal_owner_change" ref="3d19cb78841fd7e73fdddca0daeac22b" args="()" -->
 
858
</div>
 
859
<a class="anchor" id="a3d19cb78841fd7e73fdddca0daeac22b"></a><!-- doxytag: member="Gtk::Clipboard::signal_owner_change" ref="a3d19cb78841fd7e73fdddca0daeac22b" args="()" -->
913
860
<div class="memitem">
914
861
<div class="memproto">
915
862
      <table class="memname">
916
863
        <tr>
917
864
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>&lt; void,GdkEventOwnerChange* &gt; Gtk::Clipboard::signal_owner_change </td>
918
865
          <td>(</td>
919
 
          <td class="paramname"> </td>
 
866
          <td class="paramname"></td>
920
867
          <td>&#160;)&#160;</td>
921
868
          <td></td>
922
869
        </tr>
923
870
      </table>
924
871
</div>
925
872
<div class="memdoc">
926
 
 
927
 
<p>
928
 
<dl class="user" compact><dt><b>Prototype:</b></dt><dd><code>void on_my_owner_change(GdkEventOwnerChange* event)</code> </dd></dl>
929
 
 
930
 
</div>
931
 
</div><p>
932
 
<a class="anchor" name="47f0293ba7f80821537797537d5b6408"></a><!-- doxytag: member="Gtk::Clipboard::store" ref="47f0293ba7f80821537797537d5b6408" args="()" -->
 
873
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_owner_change(GdkEventOwnerChange* event)</code> </dd></dl>
 
874
 
 
875
</div>
 
876
</div>
 
877
<a class="anchor" id="a47f0293ba7f80821537797537d5b6408"></a><!-- doxytag: member="Gtk::Clipboard::store" ref="a47f0293ba7f80821537797537d5b6408" args="()" -->
933
878
<div class="memitem">
934
879
<div class="memproto">
935
880
      <table class="memname">
936
881
        <tr>
937
882
          <td class="memname">void Gtk::Clipboard::store </td>
938
883
          <td>(</td>
939
 
          <td class="paramname"> </td>
 
884
          <td class="paramname"></td>
940
885
          <td>&#160;)&#160;</td>
941
886
          <td></td>
942
887
        </tr>
944
889
</div>
945
890
<div class="memdoc">
946
891
 
947
 
<p>
948
 
Stores the current clipboard data somewhere so that it will stay around after the application has quit. <p>
949
 
<dl compact><dt><b><a class="el" href="since_2_6.html#_since_2_6000061">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
 
892
<p>Stores the current clipboard data somewhere so that it will stay around after the application has quit. </p>
 
893
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000060">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
950
894
 
951
895
</div>
952
 
</div><p>
953
 
<a class="anchor" name="2110b8de6c2e61a1cf7d71cc02ef9e47"></a><!-- doxytag: member="Gtk::Clipboard::wait_for_contents" ref="2110b8de6c2e61a1cf7d71cc02ef9e47" args="(const Glib::ustring &amp;target) const " -->
 
896
</div>
 
897
<a class="anchor" id="a2110b8de6c2e61a1cf7d71cc02ef9e47"></a><!-- doxytag: member="Gtk::Clipboard::wait_for_contents" ref="a2110b8de6c2e61a1cf7d71cc02ef9e47" args="(const Glib::ustring &amp;target) const " -->
954
898
<div class="memitem">
955
899
<div class="memproto">
956
900
      <table class="memname">
958
902
          <td class="memname"><a class="el" href="classGtk_1_1SelectionData.html">SelectionData</a> Gtk::Clipboard::wait_for_contents </td>
959
903
          <td>(</td>
960
904
          <td class="paramtype">const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
961
 
          <td class="paramname"> <em>target</em> </td>
 
905
          <td class="paramname"> <em>target</em></td>
962
906
          <td>&#160;)&#160;</td>
963
907
          <td> const</td>
964
908
        </tr>
966
910
</div>
967
911
<div class="memdoc">
968
912
 
969
 
<p>
970
 
Requests the contents of the clipboard using the given target. <p>
971
 
This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.<p>
972
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
913
<p>Requests the contents of the clipboard using the given target. </p>
 
914
<p>This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.</p>
 
915
<dl><dt><b>Parameters:</b></dt><dd>
973
916
  <table border="0" cellspacing="2" cellpadding="0">
974
917
    <tr><td valign="top"></td><td valign="top"><em>target</em>&#160;</td><td>The form into which the clipboard owner should convert the selection.</td></tr>
975
918
  </table>
 
919
  </dd>
976
920
</dl>
977
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGtk_1_1SelectionData.html">SelectionData</a> object, which will be invalid if retrieving the given target failed. </dd></dl>
 
921
<dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGtk_1_1SelectionData.html">SelectionData</a> object, which will be invalid if retrieving the given target failed. </dd></dl>
978
922
 
979
923
</div>
980
 
</div><p>
981
 
<a class="anchor" name="cd3d40ebf095dc8ec7e0ba786ea99b0d"></a><!-- doxytag: member="Gtk::Clipboard::wait_for_image" ref="cd3d40ebf095dc8ec7e0ba786ea99b0d" args="() const " -->
 
924
</div>
 
925
<a class="anchor" id="acd3d40ebf095dc8ec7e0ba786ea99b0d"></a><!-- doxytag: member="Gtk::Clipboard::wait_for_image" ref="acd3d40ebf095dc8ec7e0ba786ea99b0d" args="() const " -->
982
926
<div class="memitem">
983
927
<div class="memproto">
984
928
      <table class="memname">
985
929
        <tr>
986
930
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a>&gt; Gtk::Clipboard::wait_for_image </td>
987
931
          <td>(</td>
988
 
          <td class="paramname"> </td>
 
932
          <td class="paramname"></td>
989
933
          <td>&#160;)&#160;</td>
990
934
          <td> const</td>
991
935
        </tr>
993
937
</div>
994
938
<div class="memdoc">
995
939
 
996
 
<p>
997
 
Requests the contents of the clipboard as image and converts the result to a <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a>. <p>
998
 
This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A newly-allocated <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a> object which must be disposed with Glib::object_unref(), or <code>0</code> if retrieving the selection data failed. (This could happen for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into an image.)</dd></dl>
999
 
<dl compact><dt><b><a class="el" href="since_2_6.html#_since_2_6000058">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
 
940
<p>Requests the contents of the clipboard as image and converts the result to a <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a>. </p>
 
941
<p>This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait. </p>
 
942
<dl class="return"><dt><b>Returns:</b></dt><dd>A newly-allocated <a class="el" href="classGdk_1_1Pixbuf.html">Gdk::Pixbuf</a> object which must be disposed with Glib::object_unref(), or <code>0</code> if retrieving the selection data failed. (This could happen for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into an image.)</dd></dl>
 
943
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000057">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
1000
944
 
1001
945
</div>
1002
 
</div><p>
1003
 
<a class="anchor" name="0f02a96840cfe953d1ef30d64c8e1409"></a><!-- doxytag: member="Gtk::Clipboard::wait_for_rich_text" ref="0f02a96840cfe953d1ef30d64c8e1409" args="(const Glib::RefPtr&lt; TextBuffer &gt; &amp;buffer, std::string &amp;format)" -->
 
946
</div>
 
947
<a class="anchor" id="a0f02a96840cfe953d1ef30d64c8e1409"></a><!-- doxytag: member="Gtk::Clipboard::wait_for_rich_text" ref="a0f02a96840cfe953d1ef30d64c8e1409" args="(const Glib::RefPtr&lt; TextBuffer &gt; &amp;buffer, std::string &amp;format)" -->
1004
948
<div class="memitem">
1005
949
<div class="memproto">
1006
950
      <table class="memname">
1007
951
        <tr>
1008
 
          <td class="memname"><a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00969.html#32db3d9898c44d3b3a578b560f7758cc">std::string</a> Gtk::Clipboard::wait_for_rich_text </td>
 
952
          <td class="memname"><a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Gtk::Clipboard::wait_for_rich_text </td>
1009
953
          <td>(</td>
1010
954
          <td class="paramtype">const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGtk_1_1TextBuffer.html">TextBuffer</a> &gt;&amp;&#160;</td>
1011
955
          <td class="paramname"> <em>buffer</em>, </td>
1013
957
        <tr>
1014
958
          <td class="paramkey"></td>
1015
959
          <td></td>
1016
 
          <td class="paramtype"><a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00969.html#32db3d9898c44d3b3a578b560f7758cc">std::string</a> &amp;&#160;</td>
 
960
          <td class="paramtype"><a class="elRef" doxygen="libstdc++.tag:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> &amp;&#160;</td>
1017
961
          <td class="paramname"> <em>format</em></td><td>&#160;</td>
1018
962
        </tr>
1019
963
        <tr>
1025
969
</div>
1026
970
<div class="memdoc">
1027
971
 
1028
 
<p>
1029
 
 
1030
 
</div>
1031
 
</div><p>
1032
 
<a class="anchor" name="168e8bd1b2d97e58ed2ad465dc2f1bf8"></a><!-- doxytag: member="Gtk::Clipboard::wait_for_targets" ref="168e8bd1b2d97e58ed2ad465dc2f1bf8" args="() const " -->
 
972
</div>
 
973
</div>
 
974
<a class="anchor" id="a168e8bd1b2d97e58ed2ad465dc2f1bf8"></a><!-- doxytag: member="Gtk::Clipboard::wait_for_targets" ref="a168e8bd1b2d97e58ed2ad465dc2f1bf8" args="() const " -->
1033
975
<div class="memitem">
1034
976
<div class="memproto">
1035
977
      <table class="memname">
1036
978
        <tr>
1037
979
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a> Gtk::Clipboard::wait_for_targets </td>
1038
980
          <td>(</td>
1039
 
          <td class="paramname"> </td>
 
981
          <td class="paramname"></td>
1040
982
          <td>&#160;)&#160;</td>
1041
983
          <td> const</td>
1042
984
        </tr>
1044
986
</div>
1045
987
<div class="memdoc">
1046
988
 
1047
 
<p>
1048
 
Returns a list of targets that are present on the clipboard. <p>
1049
 
This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.<p>
1050
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>targets: The targets.</dd></dl>
1051
 
<dl compact><dt><b><a class="el" href="since_2_4.html#_since_2_4000062">Since gtkmm 2.4:</a></b></dt><dd></dd></dl>
 
989
<p>Returns a list of targets that are present on the clipboard. </p>
 
990
<p>This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.</p>
 
991
<dl class="return"><dt><b>Returns:</b></dt><dd>targets: The targets.</dd></dl>
 
992
<dl class="since_2_4"><dt><b><a class="el" href="since_2_4.html#_since_2_4000062">Since gtkmm 2.4:</a></b></dt><dd></dd></dl>
1052
993
 
1053
994
</div>
1054
 
</div><p>
1055
 
<a class="anchor" name="eac490f4cbb988fe5b6e5eefb33c2201"></a><!-- doxytag: member="Gtk::Clipboard::wait_for_text" ref="eac490f4cbb988fe5b6e5eefb33c2201" args="() const " -->
 
995
</div>
 
996
<a class="anchor" id="aeac490f4cbb988fe5b6e5eefb33c2201"></a><!-- doxytag: member="Gtk::Clipboard::wait_for_text" ref="aeac490f4cbb988fe5b6e5eefb33c2201" args="() const " -->
1056
997
<div class="memitem">
1057
998
<div class="memproto">
1058
999
      <table class="memname">
1059
1000
        <tr>
1060
1001
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a> Gtk::Clipboard::wait_for_text </td>
1061
1002
          <td>(</td>
1062
 
          <td class="paramname"> </td>
 
1003
          <td class="paramname"></td>
1063
1004
          <td>&#160;)&#160;</td>
1064
1005
          <td> const</td>
1065
1006
        </tr>
1067
1008
</div>
1068
1009
<div class="memdoc">
1069
1010
 
1070
 
<p>
1071
 
Requests the contents of the clipboard as text and converts the result to UTF-8 if necessary. <p>
1072
 
This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A UTF-8 string, which is empty if retrieving the selection data failed. (This could happen for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into text form.). </dd></dl>
 
1011
<p>Requests the contents of the clipboard as text and converts the result to UTF-8 if necessary. </p>
 
1012
<p>This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait. </p>
 
1013
<dl class="return"><dt><b>Returns:</b></dt><dd>A UTF-8 string, which is empty if retrieving the selection data failed. (This could happen for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into text form.). </dd></dl>
1073
1014
 
1074
1015
</div>
1075
 
</div><p>
1076
 
<a class="anchor" name="dc50aa1d428322a50d307fc6c0d23dc9"></a><!-- doxytag: member="Gtk::Clipboard::wait_for_uris" ref="dc50aa1d428322a50d307fc6c0d23dc9" args="() const " -->
 
1016
</div>
 
1017
<a class="anchor" id="adc50aa1d428322a50d307fc6c0d23dc9"></a><!-- doxytag: member="Gtk::Clipboard::wait_for_uris" ref="adc50aa1d428322a50d307fc6c0d23dc9" args="() const " -->
1077
1018
<div class="memitem">
1078
1019
<div class="memproto">
1079
1020
      <table class="memname">
1080
1021
        <tr>
1081
1022
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::StringArrayHandle</a> Gtk::Clipboard::wait_for_uris </td>
1082
1023
          <td>(</td>
1083
 
          <td class="paramname"> </td>
 
1024
          <td class="paramname"></td>
1084
1025
          <td>&#160;)&#160;</td>
1085
1026
          <td> const</td>
1086
1027
        </tr>
1088
1029
</div>
1089
1030
<div class="memdoc">
1090
1031
 
1091
 
<p>
1092
 
Requests the contents of the clipboard as URIs. <p>
1093
 
This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A newly-allocated <code>0</code>-terminated array of strings which must be freed with Glib::strfreev(), or <code>0</code> if retrieving the selection data failed. (This could happen for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into URI form.)</dd></dl>
1094
 
<dl compact><dt><b><a class="el" href="since_2_14.html#_since_2_14000040">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
 
1032
<p>Requests the contents of the clipboard as URIs. </p>
 
1033
<p>This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait. </p>
 
1034
<dl class="return"><dt><b>Returns:</b></dt><dd>A newly-allocated <code>0</code>-terminated array of strings which must be freed with Glib::strfreev(), or <code>0</code> if retrieving the selection data failed. (This could happen for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into URI form.)</dd></dl>
 
1035
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000040">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
1095
1036
 
1096
1037
</div>
1097
 
</div><p>
1098
 
<a class="anchor" name="fcc67f894892de4918e9f8e7fb6813e7"></a><!-- doxytag: member="Gtk::Clipboard::wait_is_image_available" ref="fcc67f894892de4918e9f8e7fb6813e7" args="() const " -->
 
1038
</div>
 
1039
<a class="anchor" id="afcc67f894892de4918e9f8e7fb6813e7"></a><!-- doxytag: member="Gtk::Clipboard::wait_is_image_available" ref="afcc67f894892de4918e9f8e7fb6813e7" args="() const " -->
1099
1040
<div class="memitem">
1100
1041
<div class="memproto">
1101
1042
      <table class="memname">
1102
1043
        <tr>
1103
1044
          <td class="memname">bool Gtk::Clipboard::wait_is_image_available </td>
1104
1045
          <td>(</td>
1105
 
          <td class="paramname"> </td>
 
1046
          <td class="paramname"></td>
1106
1047
          <td>&#160;)&#160;</td>
1107
1048
          <td> const</td>
1108
1049
        </tr>
1110
1051
</div>
1111
1052
<div class="memdoc">
1112
1053
 
1113
 
<p>
1114
 
Test to see if there is an image available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported image targets. <p>
1115
 
This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.<p>
1116
 
This function is a little faster than calling <a class="el" href="classGtk_1_1Clipboard.html#cd3d40ebf095dc8ec7e0ba786ea99b0d" title="Requests the contents of the clipboard as image and converts the result to a Gdk::Pixbuf...">wait_for_image()</a> since it doesn't need to retrieve the actual image data. <dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> is there is an image available, <code>false</code> otherwise.</dd></dl>
1117
 
<dl compact><dt><b><a class="el" href="since_2_6.html#_since_2_6000059">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
 
1054
<p>Test to see if there is an image available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported image targets. </p>
 
1055
<p>This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.</p>
 
1056
<p>This function is a little faster than calling <a class="el" href="classGtk_1_1Clipboard.html#acd3d40ebf095dc8ec7e0ba786ea99b0d" title="Requests the contents of the clipboard as image and converts the result to a Gdk::Pixbuf...">wait_for_image()</a> since it doesn't need to retrieve the actual image data. </p>
 
1057
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> is there is an image available, <code>false</code> otherwise.</dd></dl>
 
1058
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000058">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
1118
1059
 
1119
1060
</div>
1120
 
</div><p>
1121
 
<a class="anchor" name="05294bafc2322b3688dcc85523ae37db"></a><!-- doxytag: member="Gtk::Clipboard::wait_is_rich_text_available" ref="05294bafc2322b3688dcc85523ae37db" args="(const Glib::RefPtr&lt; TextBuffer &gt; &amp;buffer) const " -->
 
1061
</div>
 
1062
<a class="anchor" id="a05294bafc2322b3688dcc85523ae37db"></a><!-- doxytag: member="Gtk::Clipboard::wait_is_rich_text_available" ref="a05294bafc2322b3688dcc85523ae37db" args="(const Glib::RefPtr&lt; TextBuffer &gt; &amp;buffer) const " -->
1122
1063
<div class="memitem">
1123
1064
<div class="memproto">
1124
1065
      <table class="memname">
1126
1067
          <td class="memname">bool Gtk::Clipboard::wait_is_rich_text_available </td>
1127
1068
          <td>(</td>
1128
1069
          <td class="paramtype">const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGtk_1_1TextBuffer.html">TextBuffer</a> &gt;&amp;&#160;</td>
1129
 
          <td class="paramname"> <em>buffer</em> </td>
 
1070
          <td class="paramname"> <em>buffer</em></td>
1130
1071
          <td>&#160;)&#160;</td>
1131
1072
          <td> const</td>
1132
1073
        </tr>
1134
1075
</div>
1135
1076
<div class="memdoc">
1136
1077
 
1137
 
<p>
1138
 
Test to see if there is rich text available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported rich text targets. <p>
1139
 
This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.<p>
1140
 
This function is a little faster than calling <a class="el" href="classGtk_1_1Clipboard.html#0f02a96840cfe953d1ef30d64c8e1409">wait_for_rich_text()</a> since it doesn't need to retrieve the actual text. <dl compact><dt><b>Parameters:</b></dt><dd>
 
1078
<p>Test to see if there is rich text available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported rich text targets. </p>
 
1079
<p>This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.</p>
 
1080
<p>This function is a little faster than calling <a class="el" href="classGtk_1_1Clipboard.html#a0f02a96840cfe953d1ef30d64c8e1409">wait_for_rich_text()</a> since it doesn't need to retrieve the actual text. </p>
 
1081
<dl><dt><b>Parameters:</b></dt><dd>
1141
1082
  <table border="0" cellspacing="2" cellpadding="0">
1142
1083
    <tr><td valign="top"></td><td valign="top"><em>buffer</em>&#160;</td><td>A <a class="el" href="classGtk_1_1TextBuffer.html" title="Multi-line attributed text that can be displayed by one or more Gtk::TextView widgets...">Gtk::TextBuffer</a>. </td></tr>
1143
1084
  </table>
 
1085
  </dd>
1144
1086
</dl>
1145
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> is there is rich text available, <code>false</code> otherwise.</dd></dl>
1146
 
<dl compact><dt><b><a class="el" href="since_2_10.html#_since_2_10000049">Since gtkmm 2.10:</a></b></dt><dd></dd></dl>
 
1087
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> is there is rich text available, <code>false</code> otherwise.</dd></dl>
 
1088
<dl class="since_2_10"><dt><b><a class="el" href="since_2_10.html#_since_2_10000049">Since gtkmm 2.10:</a></b></dt><dd></dd></dl>
1147
1089
 
1148
1090
</div>
1149
 
</div><p>
1150
 
<a class="anchor" name="b1c3c7516af21ecb6a2db4db6cb8012b"></a><!-- doxytag: member="Gtk::Clipboard::wait_is_target_available" ref="b1c3c7516af21ecb6a2db4db6cb8012b" args="(const Glib::ustring &amp;target)" -->
 
1091
</div>
 
1092
<a class="anchor" id="ab1c3c7516af21ecb6a2db4db6cb8012b"></a><!-- doxytag: member="Gtk::Clipboard::wait_is_target_available" ref="ab1c3c7516af21ecb6a2db4db6cb8012b" args="(const Glib::ustring &amp;target)" -->
1151
1093
<div class="memitem">
1152
1094
<div class="memproto">
1153
1095
      <table class="memname">
1155
1097
          <td class="memname">bool Gtk::Clipboard::wait_is_target_available </td>
1156
1098
          <td>(</td>
1157
1099
          <td class="paramtype">const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
1158
 
          <td class="paramname"> <em>target</em> </td>
 
1100
          <td class="paramname"> <em>target</em></td>
1159
1101
          <td>&#160;)&#160;</td>
1160
1102
          <td></td>
1161
1103
        </tr>
1163
1105
</div>
1164
1106
<div class="memdoc">
1165
1107
 
1166
 
<p>
1167
 
Checks if a clipboard supports pasting data of a given type. <p>
1168
 
This function can be used to determine if a "Paste" menu item should be insensitive or not.<p>
1169
 
If you want to see if there's text available on the clipboard, use <a class="el" href="classGtk_1_1Clipboard.html#c30a1145696f41b5feccbbe0346702fc" title="Test to see if there is text available to be pasted This is done by requesting the...">wait_is_text_available()</a> instead. <dl compact><dt><b>Parameters:</b></dt><dd>
 
1108
<p>Checks if a clipboard supports pasting data of a given type. </p>
 
1109
<p>This function can be used to determine if a "Paste" menu item should be insensitive or not.</p>
 
1110
<p>If you want to see if there's text available on the clipboard, use <a class="el" href="classGtk_1_1Clipboard.html#ac30a1145696f41b5feccbbe0346702fc" title="Test to see if there is text available to be pasted This is done by requesting the...">wait_is_text_available()</a> instead. </p>
 
1111
<dl><dt><b>Parameters:</b></dt><dd>
1170
1112
  <table border="0" cellspacing="2" cellpadding="0">
1171
1113
    <tr><td valign="top"></td><td valign="top"><em>target</em>&#160;</td><td>A Gdk::Atom indicating which target to look for. </td></tr>
1172
1114
  </table>
 
1115
  </dd>
1173
1116
</dl>
1174
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the target is available, <code>false</code> otherwise.</dd></dl>
1175
 
<dl compact><dt><b><a class="el" href="since_2_6.html#_since_2_6000060">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
 
1117
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if the target is available, <code>false</code> otherwise.</dd></dl>
 
1118
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000059">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
1176
1119
 
1177
1120
</div>
1178
 
</div><p>
1179
 
<a class="anchor" name="c30a1145696f41b5feccbbe0346702fc"></a><!-- doxytag: member="Gtk::Clipboard::wait_is_text_available" ref="c30a1145696f41b5feccbbe0346702fc" args="() const " -->
 
1121
</div>
 
1122
<a class="anchor" id="ac30a1145696f41b5feccbbe0346702fc"></a><!-- doxytag: member="Gtk::Clipboard::wait_is_text_available" ref="ac30a1145696f41b5feccbbe0346702fc" args="() const " -->
1180
1123
<div class="memitem">
1181
1124
<div class="memproto">
1182
1125
      <table class="memname">
1183
1126
        <tr>
1184
1127
          <td class="memname">bool Gtk::Clipboard::wait_is_text_available </td>
1185
1128
          <td>(</td>
1186
 
          <td class="paramname"> </td>
 
1129
          <td class="paramname"></td>
1187
1130
          <td>&#160;)&#160;</td>
1188
1131
          <td> const</td>
1189
1132
        </tr>
1191
1134
</div>
1192
1135
<div class="memdoc">
1193
1136
 
1194
 
<p>
1195
 
Test to see if there is text available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported text targets. <p>
1196
 
This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.<p>
1197
 
This function is a little faster than calling <a class="el" href="classGtk_1_1Clipboard.html#eac490f4cbb988fe5b6e5eefb33c2201" title="Requests the contents of the clipboard as text and converts the result to UTF-8 if...">wait_for_text()</a> since it doesn't need to retrieve the actual text. <dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> is there is text available, <code>false</code> otherwise. </dd></dl>
 
1137
<p>Test to see if there is text available to be pasted This is done by requesting the TARGETS atom and checking if it contains any of the supported text targets. </p>
 
1138
<p>This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.</p>
 
1139
<p>This function is a little faster than calling <a class="el" href="classGtk_1_1Clipboard.html#aeac490f4cbb988fe5b6e5eefb33c2201" title="Requests the contents of the clipboard as text and converts the result to UTF-8 if...">wait_for_text()</a> since it doesn't need to retrieve the actual text. </p>
 
1140
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> is there is text available, <code>false</code> otherwise. </dd></dl>
1198
1141
 
1199
1142
</div>
1200
 
</div><p>
1201
 
<a class="anchor" name="f0c118eea5e64eabf911558d915af8be"></a><!-- doxytag: member="Gtk::Clipboard::wait_is_uris_available" ref="f0c118eea5e64eabf911558d915af8be" args="() const " -->
 
1143
</div>
 
1144
<a class="anchor" id="af0c118eea5e64eabf911558d915af8be"></a><!-- doxytag: member="Gtk::Clipboard::wait_is_uris_available" ref="af0c118eea5e64eabf911558d915af8be" args="() const " -->
1202
1145
<div class="memitem">
1203
1146
<div class="memproto">
1204
1147
      <table class="memname">
1205
1148
        <tr>
1206
1149
          <td class="memname">bool Gtk::Clipboard::wait_is_uris_available </td>
1207
1150
          <td>(</td>
1208
 
          <td class="paramname"> </td>
 
1151
          <td class="paramname"></td>
1209
1152
          <td>&#160;)&#160;</td>
1210
1153
          <td> const</td>
1211
1154
        </tr>
1213
1156
</div>
1214
1157
<div class="memdoc">
1215
1158
 
1216
 
<p>
1217
 
Test to see if there is a list of URIs available to be pasted This is done by requesting the TARGETS atom and checking if it contains the URI targets. <p>
1218
 
This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.<p>
1219
 
This function is a little faster than calling <a class="el" href="classGtk_1_1Clipboard.html#dc50aa1d428322a50d307fc6c0d23dc9" title="Requests the contents of the clipboard as URIs.">wait_for_uris()</a> since it doesn't need to retrieve the actual URI data. <dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> is there is an URI list available, <code>false</code> otherwise.</dd></dl>
1220
 
<dl compact><dt><b><a class="el" href="since_2_14.html#_since_2_14000039">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
 
1159
<p>Test to see if there is a list of URIs available to be pasted This is done by requesting the TARGETS atom and checking if it contains the URI targets. </p>
 
1160
<p>This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.</p>
 
1161
<p>This function is a little faster than calling <a class="el" href="classGtk_1_1Clipboard.html#adc50aa1d428322a50d307fc6c0d23dc9" title="Requests the contents of the clipboard as URIs.">wait_for_uris()</a> since it doesn't need to retrieve the actual URI data. </p>
 
1162
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> is there is an URI list available, <code>false</code> otherwise.</dd></dl>
 
1163
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000039">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
1221
1164
 
1222
1165
</div>
1223
 
</div><p>
1224
 
<hr><h2>Friends And Related Function Documentation</h2>
1225
 
<a class="anchor" name="d2c721a5e6f7cee3edc204c496a66044"></a><!-- doxytag: member="Gtk::Clipboard::wrap" ref="d2c721a5e6f7cee3edc204c496a66044" args="(GtkClipboard *object, bool take_copy=false)" -->
 
1166
</div>
 
1167
<hr/><h2>Friends And Related Function Documentation</h2>
 
1168
<a class="anchor" id="ad2c721a5e6f7cee3edc204c496a66044"></a><!-- doxytag: member="Gtk::Clipboard::wrap" ref="ad2c721a5e6f7cee3edc204c496a66044" args="(GtkClipboard *object, bool take_copy=false)" -->
1226
1169
<div class="memitem">
1227
1170
<div class="memproto">
1228
1171
      <table class="memname">
1247
1190
</div>
1248
1191
<div class="memdoc">
1249
1192
 
1250
 
<p>
1251
 
A <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <p>
1252
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
1193
<p>A <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
 
1194
<dl><dt><b>Parameters:</b></dt><dd>
1253
1195
  <table border="0" cellspacing="2" cellpadding="0">
1254
1196
    <tr><td valign="top"></td><td valign="top"><em>object</em>&#160;</td><td>The C instance. </td></tr>
1255
1197
    <tr><td valign="top"></td><td valign="top"><em>take_copy</em>&#160;</td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
1256
1198
  </table>
 
1199
  </dd>
1257
1200
</dl>
1258
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
 
1201
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
1259
1202
 
1260
1203
</div>
1261
 
</div><p>
1262
 
<hr>The documentation for this class was generated from the following file:<ul>
1263
 
<li>gtkmm/clipboard.h</ul>
1264
 
</div>
1265
 
<hr size="1"><address style="text-align: right;"><small>Generated on Sun Sep 6 18:45:26 2009 for gtkmm by&#160;
 
1204
</div>
 
1205
<hr/>The documentation for this class was generated from the following file:<ul>
 
1206
<li>gtkmm/clipboard.h</li>
 
1207
</ul>
 
1208
</div>
 
1209
<hr size="1"/><address style="text-align: right;"><small>Generated on Mon Sep 21 16:34:33 2009 for gtkmm by&#160;
1266
1210
<a href="http://www.doxygen.org/index.html">
1267
 
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 
1211
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
1268
1212
</body>
1269
1213
</html>