:right-sidebar: True

MediaControls
===================================================================

.. currentmodule:: gi.repository.Gtk





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


Superclasses: :class:`~gi.repository.Gtk.Widget`, :class:`~gi.repository.GObject.InitiallyUnowned`, :class:`~gi.repository.GObject.Object`



Implemented Interfaces: :class:`~gi.repository.Gtk.Accessible`, :class:`~gi.repository.Gtk.Buildable`, :class:`~gi.repository.Gtk.ConstraintTarget`



``GtkMediaControls`` is a widget to show controls for a video.


.. image:: https://docs.gtk.org/gtk4/media-controls.png


Usually, ``GtkMediaControls`` is used as part of :obj:`~gi.repository.Gtk.Video`.



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

.. rst-class:: interim-class

.. class:: MediaControls
   :no-index:


   .. classmethod:: new(stream: ~gi.repository.Gtk.MediaStream | None = None) -> ~gi.repository.Gtk.Widget

      Creates a new ``GtkMediaControls`` managing the ``stream`` passed to it.







      :param stream: a ``GtkMediaStream`` to manage









Methods
-------

.. rst-class:: interim-class

.. class:: MediaControls
   :no-index:


   .. method:: get_media_stream() -> ~gi.repository.Gtk.MediaStream | None

      Gets the media stream managed by ``controls`` or :const:`None` if none.










   .. method:: set_media_stream(stream: ~gi.repository.Gtk.MediaStream | None = None) -> None

      Sets the stream that is controlled by ``controls``.







      :param stream: a ``GtkMediaStream``









Properties
----------

.. rst-class:: interim-class

.. class:: MediaControls
   :no-index:
   

   .. attribute:: props.media_stream
      :type: ~gi.repository.Gtk.MediaStream

      The media-stream managed by this object or :const:`None` if none.