[][src]Trait gio::IconExt

pub trait IconExt: 'static {
    fn equal<P: IsA<Icon>>(&self, icon2: Option<&P>) -> bool;
fn serialize(&self) -> Option<Variant>;
fn to_string(&self) -> Option<GString>; }

Trait containing all Icon methods.


BytesIcon, Emblem, EmblemedIcon, FileIcon, Icon, LoadableIcon, ThemedIcon

Required methods

fn equal<P: IsA<Icon>>(&self, icon2: Option<&P>) -> bool

Checks if two icons are equal.


pointer to the second Icon.


true if self is equal to icon2. false otherwise.

fn serialize(&self) -> Option<Variant>

Serializes a Icon into a glib::Variant. An equivalent Icon can be retrieved back by calling Icon::deserialize on the returned value. As serialization will avoid using raw icon data when possible, it only makes sense to transfer the glib::Variant between processes on the same machine, (as opposed to over the network), and within the same file system namespace.


a glib::Variant, or None when serialization fails.

fn to_string(&self) -> Option<GString>

Generates a textual representation of self that can be used for serialization such as when passing self to a different process or saving it to persistent storage. Use Icon::new_for_string to get self back from the returned string.

The encoding of the returned string is proprietary to Icon except in the following two cases

  • If self is a FileIcon, the returned string is a native path (such as /path/to/my icon.png) without escaping if the File for self is a native file. If the file is not native, the returned string is the result of File::get_uri (such as sftp://path/to/my%20icon.png).

  • If self is a ThemedIcon with exactly one name and no fallbacks, the encoding is simply the name (such as network-server).


An allocated NUL-terminated UTF8 string or None if self can't be serialized. Use g_free to free.

Loading content...


impl<O: IsA<Icon>> IconExt for O[src]

Loading content...