GI.Gio.Objects.Emblem

Emblem is an implementation of Icon that supports having an emblem, which is an icon with additional properties. It can than be added to a EmblemedIcon.

Currently, only metainformation about the emblem's origin is supported. More may be added in the future.

Exported types

newtype Emblem

Memory-managed wrapper type.

Constructors

Emblem (ManagedPtr Emblem)

Instances

GObject Emblem

Defined in GI.Gio.Objects.Emblem

Methods

gobjectType :: IO GType

HasParentTypes Emblem

Defined in GI.Gio.Objects.Emblem

type ParentTypes Emblem

Defined in GI.Gio.Objects.Emblem

type ParentTypes Emblem = Object ': (Icon ': ([] :: [Type]))

class (GObject o, IsDescendantOf Emblem o) => IsEmblem o

Type class for types which can be safely cast to Emblem, for instance with toEmblem.

Instances

(GObject o, IsDescendantOf Emblem o) => IsEmblem o

Defined in GI.Gio.Objects.Emblem

toEmblem :: (MonadIO m, IsEmblem o) => o -> m Emblem

Cast to Emblem, for types for which this is known to be safe. For general casts, use castTo.

noEmblem :: Maybe Emblem

A convenience alias for Nothing :: Maybe Emblem.

Methods

getIcon

emblemGetIcon

Arguments

:: (HasCallStack, MonadIO m, IsEmblem a)

=> a

emblem: a Emblem from which the icon should be extracted.

-> m Icon

Returns: a Icon. The returned object belongs to the emblem and should not be modified or freed.

Gives back the icon from emblem.

Since: 2.18

getOrigin

emblemGetOrigin

Arguments

:: (HasCallStack, MonadIO m, IsEmblem a)

=> a

emblem: a Emblem

-> m EmblemOrigin

Returns: the origin of the emblem

Gets the origin of the emblem.

Since: 2.18

new

emblemNew

Arguments

:: (HasCallStack, MonadIO m, IsIcon a)

=> a

icon: a GIcon containing the icon.

-> m Emblem

Returns: a new Emblem.

Creates a new emblem for icon.

Since: 2.18

newWithOrigin

emblemNewWithOrigin

Arguments

:: (HasCallStack, MonadIO m, IsIcon a)

=> a

icon: a GIcon containing the icon.

-> EmblemOrigin

origin: a GEmblemOrigin enum defining the emblem's origin

-> m Emblem

Returns: a new Emblem.

Creates a new emblem for icon.

Since: 2.18

Properties

icon

No description available in the introspection data.

constructEmblemIcon :: (IsEmblem o, IsObject a) => a -> IO (GValueConstruct o)

Construct a GValueConstruct with valid value for the “icon” property. This is rarely needed directly, but it is used by new.

getEmblemIcon :: (MonadIO m, IsEmblem o) => o -> m (Maybe Object)

Get the value of the “icon” property. When overloading is enabled, this is equivalent to

get emblem #icon

origin

No description available in the introspection data.

constructEmblemOrigin :: IsEmblem o => EmblemOrigin -> IO (GValueConstruct o)

Construct a GValueConstruct with valid value for the “origin” property. This is rarely needed directly, but it is used by new.

getEmblemOrigin :: (MonadIO m, IsEmblem o) => o -> m EmblemOrigin

Get the value of the “origin” property. When overloading is enabled, this is equivalent to

get emblem #origin