Struct ContentProvider

pub struct ContentProvider { /* private fields */ }

A ContentProvider is used to provide content for the clipboard or for drag-and-drop operations in a number of formats.

To create a ContentProvider, use for_value() or for_bytes().

GDK knows how to handle common text and image formats out-of-the-box. See ContentSerializer and ContentDeserializer if you want to add support for application-specific data formats.

Properties

formats

The possible formats that the provider can provide its data in.

Readable

storable-formats

The subset of formats that clipboard managers should store this provider’s data in.

Readable

Signals

content-changed

Emitted whenever the content provided by this provider has changed.

Implements

ContentProviderExt, ContentProviderExtManual

GLib type: GObject with reference counted clone semantics.

Implementations

impl ContentProvider

pub const NONE: Option<&'static ContentProvider> = None

pub fn for_bytes(mime_type: &str, bytes: &Bytes) -> ContentProvider

Create a content provider that provides the given @bytes as data for the given @mime_type.

mime_type

the mime type

bytes

a GBytes with the data for @mime_type

Returns

a new ContentProvider

pub fn for_value(value: &Value) -> ContentProvider

Create a content provider that provides the given @value.

value

a GValue

Returns

a new ContentProvider

pub fn new_union(providers: &[ContentProvider]) -> ContentProvider

Creates a content provider that represents all the given @providers.

Whenever data needs to be written, the union provider will try the given @providers in the given order and the first one supporting a format will be chosen to provide it.

This allows an easy way to support providing data in different formats. For example, an image may be provided by its file and by the image contents with a call such as ⚠️ The following code is in c ⚠️

gdk_content_provider_new_union ((GdkContentProvider *[2]) {
                                  gdk_content_provider_new_typed (G_TYPE_FILE, file),
                                  gdk_content_provider_new_typed (GDK_TYPE_TEXTURE, texture)
                                }, 2);

providers

The ContentProviders to present the union of

Returns

a new ContentProvider

Trait Implementations

impl Clone for ContentProvider

fn clone(&self) -> Self

Makes a clone of this shared reference.

This increments the strong reference count of the object. Dropping the object will decrement it again.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ContentProvider

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl HasParamSpec for ContentProvider

type ParamSpec = ParamSpecObject

type SetValue = ContentProvider

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, ContentProvider>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for ContentProvider

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Hashes the memory address of this object.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: ContentProviderImpl> IsSubclassable<T> for ContentProvider

fn class_init(class: &mut Class<Self>)

Override the virtual methods of this class for the given subclass and do other class initialization.

fn instance_init(instance: &mut InitializingObject<T>)

Instance specific initialization.

impl Ord for ContentProvider

fn cmp(&self, other: &Self) -> Ordering

Comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl ParentClassIs for ContentProvider

type Parent = Object

impl<OT: ObjectType> PartialEq<OT> for ContentProvider

fn eq(&self, other: &OT) -> bool

Equality for two GObjects.

Two GObjects are equal if their memory addresses are equal.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for ContentProvider

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

Partial comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for ContentProvider

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for ContentProvider