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

Properties

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

hue : int mediaObject : QMediaObject* const saturation : int

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

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)

Signals

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

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

Detailed Description

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.

[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().

[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().

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

Signals that a video widgets's hue has changed.

Note: Notifier signal for property hue.

See also hue().

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

Signals that a video widgets's saturation has changed.

Note: Notifier signal for property saturation.

See also saturation().

[virtual] QVideoWidget::~QVideoWidget()

Destroys a video widget.

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

Reimplements: QWidget::event(QEvent *event).

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

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

Reimplements: QWidget::hideEvent(QHideEvent *event).

Handles the hide event.

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

Reimplements: QWidget::moveEvent(QMoveEvent *event).

Handles the move event.

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

Reimplements: QWidget::paintEvent(QPaintEvent *event).

Handles the paint event.

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

Reimplements: QWidget::resizeEvent(QResizeEvent *event).

Handles the resize event.

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

Reimplements: QWidget::showEvent(QShowEvent *event).

Handles the show event.

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

Reimplements an access function for property: QWidget::sizeHint.

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