Struct gdk4::ContentProvider

#[repr(transparent)]
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

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 (G_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

Returns a copy of the value.

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 Display 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,

Feeds this value into the given Hasher.

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

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

This method tests for self and other values to be equal, and is used by ==.

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

This method 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>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method 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