:right-sidebar: True

Binding
===================================================================

.. currentmodule:: gi.repository.GObject


.. versionadded:: 2.26




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


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





:Constructors:

::

    Binding(**properties)





Methods
-------

.. rst-class:: interim-class

.. class:: Binding
   :no-index:


   .. method:: unbind()

      Explicitly releases the binding between the source and the target
      property expressed by ``binding``.

      This function will release the reference that is being held on
      the ``binding`` instance if the binding is still bound; if you want to hold on
      to the :obj:`~gi.repository.GObject.Binding` instance after calling :func:`~gi.repository.GObject.Binding.unbind`, you will need
      to hold a reference to it.

      Note however that this function does not take ownership of ``binding``, it
      only unrefs the reference that was initially created by
      :func:`~gi.repository.GObject.Object.bind_property` and is owned by the binding.



      .. versionadded:: 2.38












Properties
----------

.. rst-class:: interim-class

.. class:: Binding
   :no-index:
   

   .. attribute:: props.flags
      :type: ~gi.repository.GObject.BindingFlags

      Flags to be used to control the :obj:`~gi.repository.GObject.Binding`



      .. versionadded:: 2.26





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

      The :obj:`~gi.repository.GObject.Object` that should be used as the source of the binding



      .. versionadded:: 2.26





   .. attribute:: props.source_property
      :type: str

      The name of the property of :obj:`~gi.repository.GObject.Binding`:source that should be used
      as the source of the binding.

      This should be in [canonical form][canonical-parameter-names] to get the
      best performance.



      .. versionadded:: 2.26





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

      The :obj:`~gi.repository.GObject.Object` that should be used as the target of the binding



      .. versionadded:: 2.26





   .. attribute:: props.target_property
      :type: str

      The name of the property of :obj:`~gi.repository.GObject.Binding`:target that should be used
      as the target of the binding.

      This should be in [canonical form][canonical-parameter-names] to get the
      best performance.



      .. versionadded:: 2.26