:right-sidebar: True

Emblem
===================================================================

.. currentmodule:: gi.repository.Gio





.. class:: Emblem(**properties: ~typing.Any)
   :no-contents-entry:


Superclasses: :class:`~gi.repository.GObject.Object`



Implemented Interfaces: :class:`~gi.repository.Gio.Icon`



``GEmblem`` is an implementation of :obj:`~gi.repository.Gio.Icon` that supports
having an emblem, which is an icon with additional properties.
It can than be added to a :obj:`~gi.repository.Gio.EmblemedIcon`\.

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


Constructors
------------

.. rst-class:: interim-class

.. class:: Emblem
   :no-index:


   .. classmethod:: new(icon: ~gi.repository.Gio.Icon) -> ~gi.repository.Gio.Emblem

      Creates a new emblem for ``icon``\.


      .. versionadded:: 2.18





      :param icon: a GIcon containing the icon.




   .. classmethod:: new_with_origin(icon: ~gi.repository.Gio.Icon, origin: ~gi.repository.Gio.EmblemOrigin) -> ~gi.repository.Gio.Emblem

      Creates a new emblem for ``icon``\.


      .. versionadded:: 2.18





      :param icon: a GIcon containing the icon.

      :param origin: a GEmblemOrigin enum defining the emblem's origin








Methods
-------

.. rst-class:: interim-class

.. class:: Emblem
   :no-index:


   .. method:: get_icon() -> ~gi.repository.Gio.Icon

      Gives back the icon from ``emblem``\.


      .. versionadded:: 2.18








   .. method:: get_origin() -> ~gi.repository.Gio.EmblemOrigin

      Gets the origin of the emblem.


      .. versionadded:: 2.18












Properties
----------

.. rst-class:: interim-class

.. class:: Emblem
   :no-index:
   

   .. attribute:: props.icon
      :type: ~gi.repository.GObject.Object

      The type of the None singleton.



      .. versionadded:: 2.18





   .. attribute:: props.origin
      :type: ~gi.repository.Gio.EmblemOrigin

      The type of the None singleton.



      .. versionadded:: 2.18