QVideoWidget Class

The QVideoWidget class provides a widget which presents video produced by a media object. More...

Header:	#include <QVideoWidget>
qmake:	QT += multimediawidgets
Inherits:	QWidget and QMediaBindableInterface
Inherited By:	QCameraViewfinder

• List of all members, including inherited members
• Obsolete members

Properties

aspectRatioMode : Qt::AspectRatioMode brightness : int contrast : int fullScreen : bool

hue : int mediaObject : QMediaObject* const saturation : int

• 59 properties inherited from QWidget
• 1 property inherited from QObject

Public Functions

	QVideoWidget(QWidget *parent = nullptr)
virtual	~QVideoWidget()
Qt::AspectRatioMode	aspectRatioMode() const
int	brightness() const
int	contrast() const
int	hue() const
bool	isFullScreen() const
int	saturation() const

Reimplemented Public Functions

virtual QMediaObject *	mediaObject() const override
virtual QSize	sizeHint() const override

• 216 public functions inherited from QWidget
• 1 public function inherited from QMediaBindableInterface
• 31 public functions inherited from QObject
• 14 public functions inherited from QPaintDevice

Public Slots

void	setAspectRatioMode(Qt::AspectRatioMode mode)
void	setBrightness(int brightness)
void	setContrast(int contrast)
void	setFullScreen(bool fullScreen)
void	setHue(int hue)
void	setSaturation(int saturation)

• 19 public slots inherited from QWidget
• 1 public slot inherited from QObject

Signals

void	brightnessChanged(int brightness)
void	contrastChanged(int contrast)
void	fullScreenChanged(bool fullScreen)
void	hueChanged(int hue)
void	saturationChanged(int saturation)

• 3 signals inherited from QWidget
• 2 signals inherited from QObject

Static Public Members

const QMetaObject

staticMetaObject

• 5 static public members inherited from QWidget
• 9 static public members inherited from QObject

Reimplemented Protected Functions

virtual bool	event(QEvent *event) override
virtual void	hideEvent(QHideEvent *event) override
virtual void	moveEvent(QMoveEvent *event) override
virtual void	paintEvent(QPaintEvent *event) override
virtual void	resizeEvent(QResizeEvent *event) override
virtual void	showEvent(QShowEvent *event) override

• 35 protected functions inherited from QWidget
• 1 protected function inherited from QMediaBindableInterface
• 9 protected functions inherited from QObject
• 1 protected function inherited from QPaintDevice

Protected Variables

QVideoWidgetPrivate *

d_ptr

Additional Inherited Members

• 35 protected functions inherited from QWidget
• 1 protected function inherited from QMediaBindableInterface
• 9 protected functions inherited from QObject
• 1 protected function inherited from QPaintDevice
• 1 protected slot inherited from QWidget

Detailed Description

The QVideoWidget class provides a widget which presents video produced by a media object.

Attaching a QVideoWidget to a QMediaObject allows it to display the video or image output of that media object. A QVideoWidget is attached to media object by passing a pointer to the QMediaObject in its constructor, and detached by destroying the QVideoWidget.

player = new QMediaPlayer;

playlist = new QMediaPlaylist(player);
playlist->addMedia(QUrl("http://example.com/myclip1.mp4"));
playlist->addMedia(QUrl("http://example.com/myclip2.mp4"));

videoWidget = new QVideoWidget;
player->setVideoOutput(videoWidget);

videoWidget->show();
playlist->setCurrentIndex(1);
player->play();

Note: Only a single display output can be attached to a media object at one time.

See also QMediaObject, QMediaPlayer, and QGraphicsVideoItem.

Member Function Documentation

QVideoWidget::QVideoWidget(QWidget *parent = nullptr)

Constructs a new video widget.

The parent is passed to QWidget.

[virtual] QVideoWidget::~QVideoWidget()

Destroys a video widget.

[signal] void QVideoWidget::brightnessChanged(int brightness)

Signals that a video widgets's brightness adjustment has changed.

Note: Notifier signal for property brightness.

See also brightness().

[signal] void QVideoWidget::contrastChanged(int contrast)

Signals that a video widgets's contrast adjustment has changed.

Note: Notifier signal for property contrast.

See also contrast().

[override virtual protected] bool QVideoWidget::event(QEvent *event)

Reimplemented from QWidget::event().

Current event event. Returns the value of the baseclass QWidget::event(QEvent *event) function.

[signal] void QVideoWidget::fullScreenChanged(bool fullScreen)

Signals that the fullScreen mode of a video widget has changed.

Note: Notifier signal for property fullScreen.

See also isFullScreen().

[override virtual protected] void QVideoWidget::hideEvent(QHideEvent *event)

Reimplemented from QWidget::hideEvent().

Handles the hide event.

[signal] void QVideoWidget::hueChanged(int hue)

Signals that a video widgets's hue has changed.

Note: Notifier signal for property hue.

See also hue().

[override virtual protected] void QVideoWidget::moveEvent(QMoveEvent *event)

Reimplemented from QWidget::moveEvent().

Handles the move event.

[override virtual protected] void QVideoWidget::paintEvent(QPaintEvent *event)

Reimplemented from QWidget::paintEvent().

Handles the paint event.

[override virtual protected] void QVideoWidget::resizeEvent(QResizeEvent *event)

Reimplemented from QWidget::resizeEvent().

Handles the resize event.

[signal] void QVideoWidget::saturationChanged(int saturation)

Signals that a video widgets's saturation has changed.

Note: Notifier signal for property saturation.

See also saturation().

[override virtual protected] void QVideoWidget::showEvent(QShowEvent *event)

Reimplemented from QWidget::showEvent().

Handles the show event.

[override virtual] QSize QVideoWidget::sizeHint() const

Reimplemented from QWidget::sizeHint().

Returns the size hint for the current back end, if there is one, or else the size hint from QWidget.