Struct gio::DBusMessage

source · [−]

#[repr(transparent)]
pub struct DBusMessage { /* private fields */ }

Expand description

A type for representing D-Bus messages that can be sent or received on a DBusConnection.

Implementations

source

impl DBusMessage

source

pub fn new() -> DBusMessage

Creates a new empty DBusMessage.

Returns

A DBusMessage. Free with g_object_unref().

source

pub fn from_blob(
blob: &[u8 ],
capabilities: DBusCapabilityFlags
) -> Result<DBusMessage, Error>

Creates a new DBusMessage from the data stored at blob. The byte order that the message was in can be retrieved using byte_order().

If the blob cannot be parsed, contains invalid fields, or contains invalid headers, IOErrorEnum::InvalidArgument will be returned.

`blob`

A blob representing a binary D-Bus message.

`capabilities`

A DBusCapabilityFlags describing what protocol features are supported.

Returns

A new DBusMessage or None if error is set. Free with g_object_unref().

source

pub fn new_method_call(
 name: Option<&str>,
 path: &str,
 interface_: Option<&str>,
 method: &str
) -> DBusMessage

Creates a new DBusMessage for a method call.

Returns

A DBusMessage. Free with g_object_unref().

source

pub fn new_signal(path: &str, interface_: &str, signal: &str) -> DBusMessage

Creates a new DBusMessage for a signal emission.

Returns

A DBusMessage. Free with g_object_unref().

source

pub fn copy(&self) -> Result<DBusMessage, Error>

source

pub fn arg0(&self) -> Option<GString>

Convenience to get the first item in the body of self.

Returns

The string item or None if the first item in the body of self is not a string.

source

pub fn body(&self) -> Option<Variant>

Gets the body of a message.

Returns

A glib::Variant or None if the body is empty. Do not free, it is owned by self.

source

pub fn byte_order(&self) -> DBusMessageByteOrder

Gets the byte order of self.

pub fn destination(&self) -> Option<GString>

Convenience getter for the DBusMessageHeaderField::Destination header field.

pub fn error_name(&self) -> Option<GString>

Convenience getter for the DBusMessageHeaderField::ErrorName header field.

pub fn flags(&self) -> DBusMessageFlags

Gets the flags for self.

Returns

Flags that are set (typically values from the DBusMessageFlags enumeration bitwise ORed together).

Gets a header field on self.

The caller is responsible for checking the type of the returned glib::Variant matches what is expected.

`header_field`

A 8-bit unsigned integer (typically a value from the DBusMessageHeaderField enumeration)

Returns

A glib::Variant with the value if the header was found, None otherwise. Do not free, it is owned by self.

source

pub fn interface(&self) -> Option<GString>

Convenience getter for the DBusMessageHeaderField::Interface header field.

pub fn is_locked(&self) -> bool

Checks whether self is locked. To monitor changes to this value, conncet to the signal::glib::Object::notify signal to listen for changes on the property::DBusMessage::locked property.

Returns

true if self is locked, false otherwise.

source

pub fn member(&self) -> Option<GString>

Convenience getter for the DBusMessageHeaderField::Member header field.

pub fn message_type(&self) -> DBusMessageType

Gets the type of self.

Returns

A 8-bit unsigned integer (typically a value from the DBusMessageType enumeration).

source

pub fn num_unix_fds(&self) -> u32

This is supported on Unix only.

Convenience getter for the DBusMessageHeaderField::NumUnixFds header field.

pub fn path(&self) -> Option<GString>

Convenience getter for the DBusMessageHeaderField::Path header field.

pub fn reply_serial(&self) -> u32

Convenience getter for the DBusMessageHeaderField::ReplySerial header field.

pub fn sender(&self) -> Option<GString>

Convenience getter for the DBusMessageHeaderField::Sender header field.

pub fn serial(&self) -> u32

Gets the serial for self.

pub fn signature(&self) -> GString

Convenience getter for the DBusMessageHeaderField::Signature header field.

This will always be non-None, but may be an empty string.

pub fn unix_fd_list(&self) -> Option<UnixFDList>

This is supported on Unix only.

Gets the UNIX file descriptors associated with self, if any.

This method is only available on UNIX.

The file descriptors normally correspond to G_VARIANT_TYPE_HANDLE values in the body of the message. For example, if [glib::Variant::handle()][crate::glib::Variant::handle()] returns 5, that is intended to be a reference to the file descriptor that can be accessed by g_unix_fd_list_get (list, 5, ...).

Returns

A UnixFDList or None if no file descriptors are associated. Do not free, this object is owned by self.

source

pub fn lock(&self)

If self is locked, does nothing. Otherwise locks the message.

source

pub fn new_method_error_literal(
    &self,
    error_name: &str,
    error_message: &str
) -> DBusMessage

Creates a new DBusMessage that is an error reply to self.

`error_name`

A valid D-Bus error name.

`error_message`

The D-Bus error message.

Returns

A DBusMessage. Free with g_object_unref().

source

pub fn new_method_reply(&self) -> DBusMessage

Creates a new DBusMessage that is a reply to self.

Returns

DBusMessage. Free with g_object_unref().

source

pub fn print(&self, indent: u32) -> GString

Produces a human-readable multi-line description of self.

The contents of the description has no ABI guarantees, the contents and formatting is subject to change at any time. Typical output looks something like this:

Flags:   none
Version: 0
Serial:  4
Headers:
  path -> objectpath '/org/gtk/GDBus/TestObject'
  interface -> 'org.gtk.GDBus.TestInterface'
  member -> 'GimmeStdout'
  destination -> ':1.146'
Body: ()
UNIX File Descriptors:
  (none)

or

Flags:   no-reply-expected
Version: 0
Serial:  477
Headers:
  reply-serial -> uint32 4
  destination -> ':1.159'
  sender -> ':1.146'
  num-unix-fds -> uint32 1
Body: ()
UNIX File Descriptors:
  fd 12: dev=0:10,mode=020620,ino=5,uid=500,gid=5,rdev=136:2,size=0,atime=1273085037,mtime=1273085851,ctime=1272982635

`indent`

Indentation level.

Returns

A string that should be freed with g_free().

source

pub fn set_body(&self, body: &Variant)

Sets the body self. As a side-effect the DBusMessageHeaderField::Signature header field is set to the type string of body (or cleared if body is None).

If body is floating, self assumes ownership of body.

`body`

Either None or a glib::Variant that is a tuple.

source

pub fn set_byte_order(&self, byte_order: DBusMessageByteOrder)

Sets the byte order of self.

`byte_order`

The byte order.

source

pub fn set_destination(&self, value: Option<&str>)

Convenience setter for the DBusMessageHeaderField::Destination header field.

`value`

The value to set.

source

pub fn set_error_name(&self, value: &str)

Convenience setter for the DBusMessageHeaderField::ErrorName header field.

`value`

The value to set.

source

pub fn set_flags(&self, flags: DBusMessageFlags)

Sets the flags to set on self.

`flags`

Flags for self that are set (typically values from the DBusMessageFlags enumeration bitwise ORed together).

source

pub fn set_header(
 &self,
 header_field: DBusMessageHeaderField,
 value: Option<&Variant>
)

Sets a header field on self.

If value is floating, self assumes ownership of value.

`header_field`

A 8-bit unsigned integer (typically a value from the DBusMessageHeaderField enumeration)

`value`

A glib::Variant to set the header field or None to clear the header field.

source

pub fn set_interface(&self, value: Option<&str>)

Convenience setter for the DBusMessageHeaderField::Interface header field.

`value`

The value to set.

source

pub fn set_member(&self, value: Option<&str>)

Convenience setter for the DBusMessageHeaderField::Member header field.

`value`

The value to set.

source

pub fn set_message_type(&self, type_: DBusMessageType)

Sets self to be of type_.

`type_`

A 8-bit unsigned integer (typically a value from the DBusMessageType enumeration).

source

pub fn set_num_unix_fds(&self, value: u32)

This is supported on Unix only.

Convenience setter for the DBusMessageHeaderField::NumUnixFds header field.

`value`

The value to set.

source

pub fn set_path(&self, value: Option<&str>)

Convenience setter for the DBusMessageHeaderField::Path header field.

`value`

The value to set.

source

pub fn set_reply_serial(&self, value: u32)

Convenience setter for the DBusMessageHeaderField::ReplySerial header field.

`value`

The value to set.

source

pub fn set_sender(&self, value: Option<&str>)

Convenience setter for the DBusMessageHeaderField::Sender header field.

`value`

The value to set.

source

pub fn set_serial(&self, serial: u32)

Sets the serial for self.

`serial`

A guint32.

source

pub fn set_signature(&self, value: Option<&str>)

Convenience setter for the DBusMessageHeaderField::Signature header field.

`value`

The value to set.

source

pub fn set_unix_fd_list(&self, fd_list: Option<&impl IsA<UnixFDList>>)

This is supported on Unix only.

Sets the UNIX file descriptors associated with self. As a side-effect the DBusMessageHeaderField::NumUnixFds header field is set to the number of fds in fd_list (or cleared if fd_list is None).

This method is only available on UNIX.

When designing D-Bus APIs that are intended to be interoperable, please note that non-GDBus implementations of D-Bus can usually only access file descriptors if they are referenced by a value of type G_VARIANT_TYPE_HANDLE in the body of the message.

`fd_list`

A UnixFDList or None.

source

pub fn to_blob(
&self,
capabilities: DBusCapabilityFlags
) -> Result<Vec<u8>, Error>

Serializes self to a blob. The byte order returned by byte_order() will be used.

`capabilities`

A DBusCapabilityFlags describing what protocol features are supported.

Returns

A pointer to a valid binary D-Bus message of out_size bytes generated by self or None if error is set. Free with g_free().

source

pub fn to_gerror(&self) -> Result<(), Error>

If self is not of type DBusMessageType::Error does nothing and returns false.

Otherwise this method encodes the error in self as a glib::Error using g_dbus_error_set_dbus_error() using the information in the DBusMessageHeaderField::ErrorName header field of self as well as the first string item in self’s body.

Returns

true if error was set, false otherwise.

source

pub fn bytes_needed(blob: &[u8 ]) -> Result<isize, Error>

Utility function to calculate how many bytes are needed to completely deserialize the D-Bus message stored at blob.

`blob`

A blob representing a binary D-Bus message.

Returns

Number of bytes needed or -1 if error is set (e.g. if blob contains invalid data or not enough data is available to determine the size).

source

pub fn connect_locked_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId

Trait Implementations

source

impl Clone for DBusMessage

source

fn clone(&self) -> Self

Returns a copy of the value. Read more

1.0.0 · source

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

Performs copy-assignment from source. Read more

source

impl Debug for DBusMessage

source

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

Formats the value using the given formatter. Read more

source

impl Default for DBusMessage

source

fn default() -> Self

Returns the “default value” for a type. Read more

source

impl Display for DBusMessage

source

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

Formats the value using the given formatter. Read more

source

impl Hash for DBusMessage

source

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

Feeds this value into the given Hasher. Read more

1.3.0 · source

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

Feeds a slice of this type into the given Hasher. Read more

source

impl Ord for DBusMessage

source

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

This method returns an Ordering between self and other. Read more

1.21.0 · source

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

Compares and returns the maximum of two values. Read more

1.21.0 · source

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

Compares and returns the minimum of two values. Read more

1.50.0 · source

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

Restrict a value to a certain interval. Read more

source

impl ParentClassIs for DBusMessage

type Parent = Object

source

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

source

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

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

1.0.0 · source

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

This method tests for !=.

source

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

source

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

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

1.0.0 · source

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

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

1.0.0 · source

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

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

1.0.0 · source

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

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

1.0.0 · source

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

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

source

impl StaticType for DBusMessage

source

fn static_type() -> Type

Returns the type identifier of Self.

source

impl Eq for DBusMessage

Auto Trait Implementations

impl RefUnwindSafe for DBusMessage

impl !Send for DBusMessage

impl !Sync for DBusMessage

impl Unpin for DBusMessage

impl UnwindSafe for DBusMessage

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

pub fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

pub fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

pub fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<T> Cast for T where
T: ObjectType,

source

fn upcast<T>(self) -> T where
T: ObjectType,
Self: IsA<T>,

Upcasts an object to a superclass or interface T. Read more

source

fn upcast_ref<T>(&self) -> &T where
T: ObjectType,
Self: IsA<T>,

Upcasts an object to a reference of its superclass or interface T. Read more

source

fn downcast<T>(self) -> Result<T, Self> where
T: ObjectType,
Self: CanDowncast<T>,

Tries to downcast to a subclass or interface implementor T. Read more

source

fn downcast_ref<T>(&self) -> Option<&T> where
T: ObjectType,
Self: CanDowncast<T>,

Tries to downcast to a reference of its subclass or interface implementor T. Read more

source

fn dynamic_cast<T>(self) -> Result<T, Self> where
T: ObjectType,

Tries to cast to an object of type T. This handles upcasting, downcasting and casting between interface and interface implementors. All checks are performed at runtime, while downcast and upcast will do many checks at compile-time already. Read more

source

fn dynamic_cast_ref<T>(&self) -> Option<&T> where
T: ObjectType,

Tries to cast to reference to an object of type T. This handles upcasting, downcasting and casting between interface and interface implementors. All checks are performed at runtime, while downcast and upcast will do many checks at compile-time already. Read more

source

unsafe fn unsafe_cast<T>(self) -> T where
T: ObjectType,

Casts to T unconditionally. Read more

source

unsafe fn unsafe_cast_ref<T>(&self) -> &T where
T: ObjectType,

Casts to &T unconditionally. Read more

source

impl<T> From<T> for T

const: unstable · source

pub fn from(t: T) -> T

Performs the conversion.

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

pub fn into(self) -> U

Performs the conversion.

source

impl IsSubclassableExt for U where
U: IsClass + ParentClassIs,

source

pub fn parent_class_init<T>(class: &mut Class) where
T: ObjectSubclass,
::Parent: IsSubclassable<T>,

source

pub fn parent_instance_init<T>(instance: &mut InitializingObject<T>) where
T: ObjectSubclass,
::Parent: IsSubclassable<T>,

source

impl<T> ObjectExt for T where
T: ObjectType,

source

pub fn is(&self) -> bool where
U: StaticType,

Returns true if the object is an instance of (can be cast to) T.

source

pub fn type_(&self) -> Type

Returns the type of the object.

source

pub fn object_class(&self) -> &Class<Object>

Returns the ObjectClass of the object. Read more

source

pub fn class(&self) -> &Class<T> where
T: IsClass,

Returns the class of the object.

source

pub fn class_of(&self) -> Option<&Class> where
U: IsClass,

Returns the class of the object in the given type T. Read more

source

pub fn interface(&self) -> Option<InterfaceRef<'_, U>> where
U: IsInterface,

Returns the interface T of the object. Read more

source

pub fn try_set_property<V>(
 &self,
 property_name: &str,
 value: V
) -> Result<(), BoolError> where
 V: ToValue,

Similar to Self::set_property but fails instead of panicking.

source

pub fn set_property<V>(&self, property_name: &str, value: V) where
V: ToValue,

Sets the property property_name of the object to value value. Read more

source

pub fn try_set_property_from_value(
 &self,
 property_name: &str,
 value: &Value
) -> Result<(), BoolError>

Similar to Self::set_property but fails instead of panicking.

source

pub fn set_property_from_value(&self, property_name: &str, value: &Value)

Sets the property property_name of the object to value value. Read more

source

pub fn try_set_properties(
&self,
property_values: &[(&str, &dyn ToValue )]
) -> Result<(), BoolError>

Similar to Self::set_properties but fails instead of panicking.

source

pub fn set_properties(&self, property_values: &[(&str, &dyn ToValue )])

Sets multiple properties of the object at once. Read more

source

pub fn try_set_properties_from_value(
&self,
property_values: &[(&str, Value )]
) -> Result<(), BoolError>

Similar to Self::set_properties_from_value but fails instead of panicking.

source

pub fn set_properties_from_value(&self, property_values: &[(&str, Value )])

Sets multiple properties of the object at once. Read more

source

pub fn try_property<V>(&self, property_name: &str) -> Result<V, BoolError> where
V: 'static + for<'b> FromValue<'b>,

Similar to Self::property but fails instead of panicking.

source

pub fn property<V>(&self, property_name: &str) -> V where
V: 'static + for<'b> FromValue<'b>,

Gets the property property_name of the object and cast it to the type V. Read more

source

pub fn try_property_value(
&self,
property_name: &str
) -> Result<Value, BoolError>

Similar to Self::property_value but fails instead of panicking.

source

pub fn property_value(&self, property_name: &str) -> Value

Gets the property property_name of the object. Read more

source

pub fn has_property(&self, property_name: &str, type_: Option<Type>) -> bool

Check if the object has a property property_name of the given type_. Read more

source

pub fn property_type(&self, property_name: &str) -> Option<Type>

Get the type of the property property_name of this object. Read more

source

pub fn find_property(&self, property_name: &str) -> Option<ParamSpec>

Get the ParamSpec of the property property_name of this object.

source

pub fn list_properties(&self) -> PtrSlice<ParamSpec>

Return all ParamSpec of the properties of this object.

source

pub fn freeze_notify(&self) -> PropertyNotificationFreezeGuard

Freeze all property notifications until the return guard object is dropped. Read more

source

pub unsafe fn set_qdata<QD>(&self, key: Quark, value: QD) where
QD: 'static,

Set arbitrary data on this object with the given key. Read more

source

pub unsafe fn qdata<QD>(&self, key: Quark) -> Option<NonNull<QD>> where
QD: 'static,

Return previously set arbitrary data of this object with the given key. Read more

source

pub unsafe fn steal_qdata<QD>(&self, key: Quark) -> Option<QD> where
QD: 'static,

Retrieve previously set arbitrary data of this object with the given key. Read more

source

pub unsafe fn set_data<QD>(&self, key: &str, value: QD) where
QD: 'static,

Set arbitrary data on this object with the given key. Read more

source

pub unsafe fn data<QD>(&self, key: &str) -> Option<NonNull<QD>> where
QD: 'static,

Return previously set arbitrary data of this object with the given key. Read more

source

pub unsafe fn steal_data<QD>(&self, key: &str) -> Option<QD> where
QD: 'static,

Retrieve previously set arbitrary data of this object with the given key. Read more

source

pub fn block_signal(&self, handler_id: &SignalHandlerId)

Block a given signal handler. Read more

source

pub fn unblock_signal(&self, handler_id: &SignalHandlerId)

Unblock a given signal handler.

source

pub fn stop_signal_emission(&self, signal_id: SignalId, detail: Option<Quark>)

Stop emission of the currently emitted signal.

source

pub fn stop_signal_emission_by_name(&self, signal_name: &str)

Stop emission of the currently emitted signal by the (possibly detailed) signal name.

source

pub fn try_connect<F>(
 &self,
 signal_name: &str,
 after: bool,
 callback: F
) -> Result<SignalHandlerId, BoolError> where
 F: 'static + Fn(&[Value ]) -> Option<Value> + Send + Sync,

Similar to Self::connect but fails instead of panicking.

source

pub fn connect<F>(
 &self,
 signal_name: &str,
 after: bool,
 callback: F
) -> SignalHandlerId where
 F: 'static + Fn(&[Value ]) -> Option<Value> + Send + Sync,

Connect to the signal signal_name on this object. Read more

source

pub fn try_connect_id<F>(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 callback: F
) -> Result<SignalHandlerId, BoolError> where
 F: 'static + Fn(&[Value ]) -> Option<Value> + Send + Sync,

Similar to Self::connect_id but fails instead of panicking.

source

pub fn connect_id<F>(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 callback: F
) -> SignalHandlerId where
 F: 'static + Fn(&[Value ]) -> Option<Value> + Send + Sync,

Connect to the signal signal_id on this object. Read more

source

pub fn try_connect_local<F>(
 &self,
 signal_name: &str,
 after: bool,
 callback: F
) -> Result<SignalHandlerId, BoolError> where
 F: 'static + Fn(&[Value ]) -> Option<Value>,

Similar to Self::connect_local but fails instead of panicking.

source

pub fn connect_local<F>(
 &self,
 signal_name: &str,
 after: bool,
 callback: F
) -> SignalHandlerId where
 F: 'static + Fn(&[Value ]) -> Option<Value>,

Connect to the signal signal_name on this object. Read more

source

pub fn try_connect_local_id<F>(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 callback: F
) -> Result<SignalHandlerId, BoolError> where
 F: 'static + Fn(&[Value ]) -> Option<Value>,

Similar to Self::connect_local_id but fails instead of panicking.

source

pub fn connect_local_id<F>(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 callback: F
) -> SignalHandlerId where
 F: 'static + Fn(&[Value ]) -> Option<Value>,

Connect to the signal signal_id on this object. Read more

source

pub unsafe fn try_connect_unsafe<F>(
 &self,
 signal_name: &str,
 after: bool,
 callback: F
) -> Result<SignalHandlerId, BoolError> where
 F: Fn(&[Value ]) -> Option<Value>,

Similar to Self::connect_unsafe but fails instead of panicking.

source

pub unsafe fn connect_unsafe<F>(
 &self,
 signal_name: &str,
 after: bool,
 callback: F
) -> SignalHandlerId where
 F: Fn(&[Value ]) -> Option<Value>,

Connect to the signal signal_name on this object. Read more

source

pub unsafe fn try_connect_unsafe_id<F>(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 callback: F
) -> Result<SignalHandlerId, BoolError> where
 F: Fn(&[Value ]) -> Option<Value>,

Similar to Self::connect_unsafe_id but fails instead of panicking.

source

pub fn try_connect_closure(
 &self,
 signal_name: &str,
 after: bool,
 closure: RustClosure
) -> Result<SignalHandlerId, BoolError>

Similar to Self::connect_closure but fails instead of panicking.

source

pub fn connect_closure(
    &self,
    signal_name: &str,
    after: bool,
    closure: RustClosure
) -> SignalHandlerId

Connect a closure to the signal signal_name on this object. Read more

source

pub fn try_connect_closure_id(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 closure: RustClosure
) -> Result<SignalHandlerId, BoolError>

Similar to Self::connect_closure_id but fails instead of panicking.

source

pub fn connect_closure_id(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 closure: RustClosure
) -> SignalHandlerId

Connect a closure to the signal signal_id on this object. Read more

source

pub fn watch_closure(&self, closure: &impl AsRef<Closure>)

Limits the lifetime of closure to the lifetime of the object. When the object’s reference count drops to zero, the closure will be invalidated. An invalidated closure will ignore any calls to Closure::invoke. Read more

source

pub unsafe fn connect_unsafe_id<F>(
 &self,
 signal_id: SignalId,
 details: Option<Quark>,
 after: bool,
 callback: F
) -> SignalHandlerId where
 F: Fn(&[Value ]) -> Option<Value>,

Connect to the signal signal_id on this object. Read more

source

pub fn try_emit<R>(
 &self,
 signal_id: SignalId,
 args: &[&dyn ToValue ]
) -> Result<R, BoolError> where
 R: TryFromClosureReturnValue,

Similar to Self::emit but fails instead of panicking.

source

pub fn emit<R>(&self, signal_id: SignalId, args: &[&dyn ToValue ]) -> R where
R: TryFromClosureReturnValue,

Emit signal by signal id. Read more

source

pub fn try_emit_with_values(
 &self,
 signal_id: SignalId,
 args: &[Value ]
) -> Result<Option<Value>, BoolError>

Similar to Self::emit_with_values but fails instead of panicking.

source

pub fn emit_with_values(
 &self,
 signal_id: SignalId,
 args: &[Value ]
) -> Option<Value>

Same as Self::emit but takes Value for the arguments.

source

pub fn try_emit_by_name<R>(
 &self,
 signal_name: &str,
 args: &[&dyn ToValue ]
) -> Result<R, BoolError> where
 R: TryFromClosureReturnValue,

Similar to Self::emit_by_name but fails instead of panicking.

source

pub fn emit_by_name<R>(&self, signal_name: &str, args: &[&dyn ToValue ]) -> R where
R: TryFromClosureReturnValue,

Emit signal by its name. Read more

source

pub fn try_emit_by_name_with_values(
 &self,
 signal_name: &str,
 args: &[Value ]
) -> Result<Option<Value>, BoolError>

Similar to Self::emit_by_name_with_values but fails instead of panicking.

source

pub fn emit_by_name_with_values(
 &self,
 signal_name: &str,
 args: &[Value ]
) -> Option<Value>

Emit signal by its name. Read more

source

pub fn try_emit_with_details<R>(
 &self,
 signal_id: SignalId,
 details: Quark,
 args: &[&dyn ToValue ]
) -> Result<R, BoolError> where
 R: TryFromClosureReturnValue,

Similar to Self::emit_with_details but fails instead of panicking.

source

pub fn emit_with_details<R>(
 &self,
 signal_id: SignalId,
 details: Quark,
 args: &[&dyn ToValue ]
) -> R where
 R: TryFromClosureReturnValue,

Emit signal by signal id with details. Read more

source

pub fn try_emit_with_details_and_values(
 &self,
 signal_id: SignalId,
 details: Quark,
 args: &[Value ]
) -> Result<Option<Value>, BoolError>

Similar to Self::emit_with_details_and_values but fails instead of panicking.

source

pub fn emit_with_details_and_values(
 &self,
 signal_id: SignalId,
 details: Quark,
 args: &[Value ]
) -> Option<Value>

Emit signal by signal id with details. Read more

source

pub fn disconnect(&self, handler_id: SignalHandlerId)

Disconnect a previously connected signal handler.

source

pub fn connect_notify<F>(&self, name: Option<&str>, f: F) -> SignalHandlerId where
F: 'static + Fn(&T, &ParamSpec) + Send + Sync,

Connect to the notify signal of the object. Read more

source

pub fn connect_notify_local<F>(
 &self,
 name: Option<&str>,
 f: F
) -> SignalHandlerId where
 F: 'static + Fn(&T, &ParamSpec),

Connect to the notify signal of the object. Read more

source

pub unsafe fn connect_notify_unsafe<F>(
 &self,
 name: Option<&str>,
 f: F
) -> SignalHandlerId where
 F: Fn(&T, &ParamSpec),

Connect to the notify signal of the object. Read more

source

pub fn notify(&self, property_name: &str)

Notify that the given property has changed its value. Read more

source

pub fn notify_by_pspec(&self, pspec: &ParamSpec)

Notify that the given property has changed its value. Read more

source

pub fn downgrade(&self) -> WeakRef<T>

Downgrade this object to a weak reference.

source

pub fn bind_property<O>(
 &'a self,
 source_property: &'a str,
 target: &'a O,
 target_property: &'a str
) -> BindingBuilder<'a> where
 O: ObjectType,

Bind property source_property on this object to the target_property on the target object. Read more

source

pub fn ref_count(&self) -> u32

Returns the strong reference count of this object.

source

impl<T> ToClosureReturnValue for T where
T: ToValue,

source

pub fn to_closure_return_value(&self) -> Option<Value>

source

impl<T> ToOwned for T where
T: Clone,

type Owned = T

The resulting type after obtaining ownership.

source

pub fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

source

pub fn clone_into(&self, target: &mut T)

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

source

impl<T> ToSendValue for T where
T: Send + ToValue + ?Sized,

source

pub fn to_send_value(&self) -> SendValue

Returns a SendValue clone of self.

source

impl<T> ToString for T where
T: Display + ?Sized,

source

pub default fn to_string(&self) -> String

Converts the given value to a String. Read more

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T> TryFromClosureReturnValue for T where
T: 'static + for<'a> FromValue<'a> + StaticType,

source

pub fn try_from_closure_return_value(v: Option<Value>) -> Result<T, BoolError>

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

pub fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

source

impl<Super, Sub> CanDowncast for Super where
Super: IsA<Super>,
Sub: IsA<Super>,

source

Struct gio::DBusMessage

Implementations

impl DBusMessage

pub fn new() -> DBusMessage

pub fn from_blob( blob: &[u8], capabilities: DBusCapabilityFlags) -> Result<DBusMessage, Error>

pub fn new_method_call( name: Option<&str>, path: &str, interface_: Option<&str>, method: &str) -> DBusMessage

pub fn new_signal(path: &str, interface_: &str, signal: &str) -> DBusMessage

pub fn copy(&self) -> Result<DBusMessage, Error>

pub fn arg0(&self) -> Option<GString>

pub fn body(&self) -> Option<Variant>

pub fn byte_order(&self) -> DBusMessageByteOrder

pub fn destination(&self) -> Option<GString>

pub fn error_name(&self) -> Option<GString>

pub fn flags(&self) -> DBusMessageFlags

pub fn header(&self, header_field: DBusMessageHeaderField) -> Option<Variant>

pub fn interface(&self) -> Option<GString>

pub fn is_locked(&self) -> bool

pub fn member(&self) -> Option<GString>

pub fn message_type(&self) -> DBusMessageType

pub fn num_unix_fds(&self) -> u32

pub fn path(&self) -> Option<GString>

pub fn reply_serial(&self) -> u32

pub fn sender(&self) -> Option<GString>

pub fn serial(&self) -> u32

pub fn signature(&self) -> GString

pub fn unix_fd_list(&self) -> Option<UnixFDList>

pub fn lock(&self)

pub fn new_method_error_literal( &self, error_name: &str, error_message: &str) -> DBusMessage

pub fn new_method_reply(&self) -> DBusMessage

pub fn print(&self, indent: u32) -> GString

pub fn set_body(&self, body: &Variant)

pub fn set_byte_order(&self, byte_order: DBusMessageByteOrder)

pub fn set_destination(&self, value: Option<&str>)

pub fn set_error_name(&self, value: &str)

pub fn set_flags(&self, flags: DBusMessageFlags)

pub fn set_header( &self, header_field: DBusMessageHeaderField, value: Option<&Variant>)

pub fn set_interface(&self, value: Option<&str>)

pub fn set_member(&self, value: Option<&str>)

pub fn set_message_type(&self, type_: DBusMessageType)

pub fn set_num_unix_fds(&self, value: u32)

pub fn set_path(&self, value: Option<&str>)

pub fn set_reply_serial(&self, value: u32)

pub fn set_sender(&self, value: Option<&str>)

pub fn set_serial(&self, serial: u32)

pub fn set_signature(&self, value: Option<&str>)

pub fn set_unix_fd_list(&self, fd_list: Option<&impl IsA<UnixFDList>>)

pub fn to_blob( &self, capabilities: DBusCapabilityFlags) -> Result<Vec<u8>, Error>

pub fn to_gerror(&self) -> Result<(), Error>

pub fn bytes_needed(blob: &[u8]) -> Result<isize, Error>

pub fn connect_locked_notify<F: Fn(&Self) + 'static>( &self, f: F) -> SignalHandlerId

Trait Implementations

impl Clone for DBusMessage

fn clone(&self) -> Self

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

impl Debug for DBusMessage

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

impl Default for DBusMessage

fn default() -> Self

impl Display for DBusMessage

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

impl Hash for DBusMessage

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

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

impl Ord for DBusMessage

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

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

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

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

impl ParentClassIs for DBusMessage

type Parent = Object

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

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

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

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

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

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

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

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

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

impl StaticType for DBusMessage

pub fn from_blob(
blob: &[u8 ],
capabilities: DBusCapabilityFlags
) -> Result<DBusMessage, Error>

pub fn new_method_call(
name: Option<&str>,
path: &str,
interface_: Option<&str>,
method: &str
) -> DBusMessage

pub fn new_method_error_literal(
&self,
error_name: &str,
error_message: &str
) -> DBusMessage

pub fn set_header(
&self,
header_field: DBusMessageHeaderField,
value: Option<&Variant>
)

pub fn to_blob(
&self,
capabilities: DBusCapabilityFlags
) -> Result<Vec<u8>, Error>

pub fn bytes_needed(blob: &[u8 ]) -> Result<isize, Error>

pub fn connect_locked_notify<F: Fn(&Self) + 'static>(
&self,
f: F
) -> SignalHandlerId

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

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