Class

ValentClipboardAdapter

since: 1.0

Description [src] 

abstract class Valent.ClipboardAdapter : Valent.Extension {
  parent_instance: ValentExtension
}

An abstract base class for clipboard selections.

ValentClipboardAdapter is a base class for plugins that provide an interface to the desktop clipboard. This usually means reading and writing content, including notification of content changes.

.plugin File

Implementations may define the following extra fields in the .plugin file:

  • X-ClipboardAdapterPriority

    An integer indicating the adapter priority. The implementation with the lowest value will be used as the primary adapter.

Available since: 1.0

Hierarchy

hierarchy this ValentClipboardAdapter implements_0 GActionGroup this--implements_0 implements_1 GActionMap this--implements_1 ancestor_0 ValentExtension ancestor_0--this ancestor_1 ValentObject ancestor_1--ancestor_0 ancestor_2 GObject ancestor_2--ancestor_1

Ancestors

Implements

Instance methods

valent_clipboard_adapter_changed

Emits ValentClipboardAdapter::changed signal on adapter.

since: 1.0

valent_clipboard_adapter_get_mimetypes

Get the mime-types of the current clipboard content.

since: 1.0

valent_clipboard_adapter_get_timestamp

Get the timestamp of the current clipboard content.

since: 1.0

valent_clipboard_adapter_read_bytes

Get the content of adapter.

since: 1.0

valent_clipboard_adapter_read_bytes_finish

Finish an operation started by valent_clipboard_adapter_read_bytes().

since: 1.0

valent_clipboard_adapter_write_bytes

Set the content of the clipboard.

since: 1.0

valent_clipboard_adapter_write_bytes_finish

Finish an operation started by valent_clipboard_adapter_write_bytes().

since: 1.0

Methods inherited from ValentExtension (6)
valent_extension_get_context

Get the settings for this plugin.

since: 1.0

valent_extension_get_object

Get the object this plugin is bound to.

since: 1.0

valent_extension_get_settings

Get the settings for this plugin.

since: 1.0

valent_extension_plugin_state_changed

Emits GObject::notify for ValentExtension:plugin-state.

since: 1.0

valent_extension_plugin_state_check

Get the extension state, while propagating any errors that describe it.

since: 1.0

valent_extension_toggle_actions

Enable or disable all actions.

since: 1.0

Methods inherited from ValentObject (8)
valent_object_chain_cancellable

Chain a cancellable to the object’s cancellable.

since: 1.0

valent_object_destroy

Destroy the object.

since: 1.0

valent_object_in_destruction

Get whether the object is destroyed or in destruction.

since: 1.0

valent_object_lock

Acquire a lock on object.

since: 1.0

valent_object_notify

Emit GObject::notify on object, on the main thread.

since: 1.0

valent_object_notify_by_pspec

Emit GObject::notify on object, on the main thread.

since: 1.0

valent_object_ref_cancellable

Get a GCancellable for the object.

since: 1.0

valent_object_unlock

Release a lock on object.

since: 1.0

Methods inherited from GObject (43)

Please see GObject for a full list of methods.

Methods inherited from GActionGroup (14)
g_action_group_action_added

Emits the GActionGroup::action-added signal on action_group.

unstable since: 2.28

g_action_group_action_enabled_changed

Emits the GActionGroup::action-enabled-changed signal on action_group.

unstable since: 2.28

g_action_group_action_removed

Emits the GActionGroup::action-removed signal on action_group.

unstable since: 2.28

g_action_group_action_state_changed

Emits the GActionGroup::action-state-changed signal on action_group.

unstable since: 2.28

g_action_group_activate_action

Activate the named action within action_group.

unstable since: 2.28

g_action_group_change_action_state

Request for the state of the named action within action_group to be changed to value.

unstable since: 2.28

g_action_group_get_action_enabled

Checks if the named action within action_group is currently enabled.

unstable since: 2.28

g_action_group_get_action_parameter_type

Queries the type of the parameter that must be given when activating the named action within action_group.

unstable since: 2.28

g_action_group_get_action_state

Queries the current state of the named action within action_group.

unstable since: 2.28

g_action_group_get_action_state_hint

Requests a hint about the valid range of values for the state of the named action within action_group.

unstable since: 2.28

g_action_group_get_action_state_type

Queries the type of the state of the named action within action_group.

unstable since: 2.28

g_action_group_has_action

Checks if the named action exists within action_group.

unstable since: 2.28

g_action_group_list_actions

Lists the actions contained within action_group.

unstable since: 2.28

g_action_group_query_action

Queries all aspects of the named action within an action_group.

unstable since: 2.32

Methods inherited from GActionMap (5)
g_action_map_add_action

Adds an action to the action_map.

unstable since: 2.32

g_action_map_add_action_entries

A convenience function for creating multiple GSimpleAction instances and adding them to a GActionMap.

unstable since: 2.32

g_action_map_lookup_action

Looks up the action with the name action_name in action_map.

unstable since: 2.32

g_action_map_remove_action

Removes the named action from the action map.

unstable since: 2.32

g_action_map_remove_action_entries

Remove actions from a GActionMap. This is meant as the reverse of g_action_map_add_action_entries().

unstable since: 2.78

Properties

Properties inherited from ValentExtension (5)
Valent.Extension:context

The ValentDevice this plugin is bound to.

since: 1.0

Valent.Extension:object

The GObject this plugin is bound to.

since: 1.0

Valent.Extension:plugin-info

The PeasPluginInfo describing this plugin.

since: 1.0

Valent.Extension:plugin-state

The ValentPluginState describing the state of the extension.

since: 1.0

Valent.Extension:settings

The GSettings for this plugin.

since: 1.0

Properties inherited from ValentObject (1)
Valent.Object:cancellable

The object GCancellable.

since: 1.0

Signals

Valent.ClipboardAdapter::changed

Emitted when the content of adapter changes.

since: 1.0

Signals inherited from ValentObject (1)
ValentObject::destroy

Emitted when the object is being destroyed.

since: 1.0

Signals inherited from GObject (1)
GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

Signals inherited from GActionGroup (4)
GActionGroup::action-added

Signals that a new action was just added to the group. This signal is emitted after the action has been added and is now visible.

unstable since: 2.28

GActionGroup::action-enabled-changed

Signals that the enabled status of the named action has changed.

unstable since: 2.28

GActionGroup::action-removed

Signals that an action is just about to be removed from the group. This signal is emitted before the action is removed, so the action is still visible and can be queried from the signal handler.

unstable since: 2.28

GActionGroup::action-state-changed

Signals that the state of the named action has changed.

unstable since: 2.28

Class structure 

struct ValentClipboardAdapterClass {
  ValentExtensionClass parent_class;
  GStrv (* get_mimetypes) (
    ValentClipboardAdapter* adapter
  );
  int64_t (* get_timestamp) (
    ValentClipboardAdapter* adapter
  );
  void (* read_bytes) (
    ValentClipboardAdapter* adapter,
    const char* mimetype,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  );
  GBytes* (* read_bytes_finish) (
    ValentClipboardAdapter* adapter,
    GAsyncResult* result,
    GError** error
  );
  void (* write_bytes) (
    ValentClipboardAdapter* adapter,
    const char* mimetype,
    GBytes* bytes,
    GCancellable* cancellable,
    GAsyncReadyCallback callback,
    gpointer user_data
  );
  gboolean (* write_bytes_finish) (
    ValentClipboardAdapter* adapter,
    GAsyncResult* result,
    GError** error
  );
  void (* changed) (
    ValentClipboardAdapter* adapter
  );
  
}

The virtual function table for ValentClipboardAdapter.

Class members
parent_class: ValentExtensionClass
No description available.
get_mimetypes: GStrv (* get_mimetypes) ( ValentClipboardAdapter* adapter )
No description available.
get_timestamp: int64_t (* get_timestamp) ( ValentClipboardAdapter* adapter )
No description available.
read_bytes: void (* read_bytes) ( ValentClipboardAdapter* adapter, const char* mimetype, GCancellable* cancellable, GAsyncReadyCallback callback, gpointer user_data )
No description available.
read_bytes_finish: GBytes* (* read_bytes_finish) ( ValentClipboardAdapter* adapter, GAsyncResult* result, GError** error )
No description available.
write_bytes: void (* write_bytes) ( ValentClipboardAdapter* adapter, const char* mimetype, GBytes* bytes, GCancellable* cancellable, GAsyncReadyCallback callback, gpointer user_data )
No description available.
write_bytes_finish: gboolean (* write_bytes_finish) ( ValentClipboardAdapter* adapter, GAsyncResult* result, GError** error )
No description available.
changed: void (* changed) ( ValentClipboardAdapter* adapter )
No description available.

Virtual methods

Valent.ClipboardAdapterClass.changed

Emits ValentClipboardAdapter::changed signal on adapter.

since: 1.0

Valent.ClipboardAdapterClass.get_mimetypes

Get the mime-types of the current clipboard content.

since: 1.0

Valent.ClipboardAdapterClass.get_timestamp

Get the timestamp of the current clipboard content.

since: 1.0

Valent.ClipboardAdapterClass.read_bytes

Get the content of adapter.

since: 1.0

Valent.ClipboardAdapterClass.read_bytes_finish

Finish an operation started by valent_clipboard_adapter_read_bytes().

since: 1.0

Valent.ClipboardAdapterClass.write_bytes

Set the content of the clipboard.

since: 1.0

Valent.ClipboardAdapterClass.write_bytes_finish

Finish an operation started by valent_clipboard_adapter_write_bytes().

since: 1.0