![]() |
![]() |
Public Types | |
typedef SigC::Slot2< void, SelectionData&, guint > | SlotGet |
e.g.: void on_get(Gtk::SelectionData& selection_data, guint info); | |
typedef SigC::Slot0<void> | SlotClear |
e.g.: void on_clear(); | |
typedef SigC::Slot1< void, const SelectionData& > | SlotReceived |
e.g.: void on_received(const SelectionData& selection_data); | |
typedef SigC::Slot1< void, const Glib::ustring& > | SlotTextReceived |
e.g.: void on_textreceived(const Glib::ustring& text); | |
Public Methods | |
virtual | ~Clipboard () |
GtkClipboard* | gobj () |
const GtkClipboard* | gobj () const |
GtkClipboard* | gobj_copy () |
Glib::RefPtr<Gdk::Display> | get_display () |
Gets the Gdk::Display associated with clipboard. | |
Glib::RefPtr<const Gdk::Display> | get_display () const |
Gets the Gdk::Display associated with clipboard. | |
bool | set (const ArrayHandle_TargetEntry& targets, const SlotGet& slot_get, const SlotClear& slot_clear) |
Glib::RefPtr<Glib::Object> | get_owner () |
If the clipboard contents callbacks were set with gtk_clipboard_set_with_owner(), and the gtk_clipboard_set_with_data() or gtk_clipboard_clear() has not subsequently called, returns the owner set by gtk_clipboard_set_with_owner(). | |
Glib::RefPtr<const Glib::Object> | get_owner () const |
If the clipboard contents callbacks were set with gtk_clipboard_set_with_owner(), and the gtk_clipboard_set_with_data() or gtk_clipboard_clear() has not subsequently called, returns the owner set by gtk_clipboard_set_with_owner(). | |
void | clear () |
Clears the contents of the clipboard. | |
void | set_text (const Glib::ustring& text) |
void | request_contents (const Glib::ustring& target, const SlotReceived& slot) |
void | request_targets (const SlotReceived& slot) |
void | request_text (const SlotTextReceived& slot) |
SelectionData | wait_for_contents (const Glib::ustring& target) const |
Glib::ustring | wait_for_text () const |
Requests the contents of the clipboard as text and converts the result to UTF-8 if necessary. | |
bool | wait_is_text_available () const |
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 names: STRING, TEXT, COMPOUND_TEXT, UTF8_STRING. | |
Static Public Methods | |
Glib::RefPtr<Clipboard> | get (GdkAtom selection=GDK_SELECTION_CLIPBOARD) |
Returns the clipboard object for the given selection. | |
Glib::RefPtr<Clipboard> | get_for_display (const Glib::RefPtr<Gdk::Display>& display, GdkAtom selection=GDK_SELECTION_CLIPBOARD) |
Returns the clipboard object for the given selection. | |
Related Functions | |
(Note that these are not member functions.) | |
Glib::RefPtr<Gtk::Clipboard> | wrap (GtkClipboard* object, bool take_copy=false) |
|
e.g.: void on_clear();
|
|
e.g.: void on_get(Gtk::SelectionData& selection_data, guint info);
|
|
e.g.: void on_received(const SelectionData& selection_data);
|
|
e.g.: void on_textreceived(const Glib::ustring& text);
|
|
|
|
Clears the contents of the clipboard. Generally this should only be called between the time you call gtk_clipboard_set_with_owner() or gtk_clipboard_set_with_data(), and when the clear_func you supplied is called. Otherwise, the clipboard may be owned by someone else. |
|
Returns the clipboard object for the given selection. See gtk_clipboard_get_for_display() for complete details.
|
|
Gets the Gdk::Display associated with clipboard.
|
|
Gets the Gdk::Display associated with clipboard.
|
|
Returns the clipboard object for the given selection. Cut/copy/paste menu items and keyboard shortcuts should use the default clipboard, returned by passing Gdk::SELECTION_CLIPBOARD for selection . (Gdk::NONE is supported as a synonym for GDK_SELECTION_CLIPBOARD for backwards compatibility reasons.) The currently-selected object or text should be provided on the clipboard identified by Gdk::SELECTION_PRIMARY. Cut/copy/paste menu items conceptually copy the contents of the Gdk::SELECTION_PRIMARY clipboard to the default clipboard, i.e. they copy the selection to what the user sees as the clipboard.
(Passing Gdk::NONE is the same as using http://www.freedesktop.org/standards/clipboards.txt for a detailed discussion of the "CLIPBOARD" vs. "PRIMARY" selections under the X window system. On Win32 the Gdk::SELECTION_PRIMARY clipboard is essentially ignored.) It's possible to have arbitrary named clipboards; if you do invent new clipboards, you should prefix the selection name with an underscore (because the ICCCM requires that nonstandard atoms are underscore-prefixed), and namespace it as well. For example, if your application called "Foo" has a special-purpose clipboard, you might call it "_FOO_SPECIAL_CLIPBOARD".
|
|
If the clipboard contents callbacks were set with gtk_clipboard_set_with_owner(), and the gtk_clipboard_set_with_data() or gtk_clipboard_clear() has not subsequently called, returns the owner set by gtk_clipboard_set_with_owner().
|
|
If the clipboard contents callbacks were set with gtk_clipboard_set_with_owner(), and the gtk_clipboard_set_with_data() or gtk_clipboard_clear() has not subsequently called, returns the owner set by gtk_clipboard_set_with_owner().
|
|
Reimplemented from Glib::ObjectBase. |
|
Reimplemented from Glib::ObjectBase. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Requests the contents of the clipboard as text and converts the result to UTF-8 if necessary. This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.
|
|
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 names: STRING, TEXT, COMPOUND_TEXT, UTF8_STRING. This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait. This function is a little faster than calling gtk_clipboard_wait_for_text() since it doesn't need to retrieve the actual text.
|
|
|