Back to Qt.io
Contact Us Blog Download Qt

QVideoWidget Class

Die Klasse QVideoWidget stellt ein Widget zur Verfügung, das ein von einem Medienobjekt erzeugtes Video darstellt. Mehr...

Kopfzeile: #include <QVideoWidget>
CMake: find_package(Qt6 REQUIRED COMPONENTS MultimediaWidgets)
target_link_libraries(mytarget PRIVATE Qt6::MultimediaWidgets)
qmake: QT += multimediawidgets
Vererbt: QWidget

Eigenschaften

Öffentliche Funktionen

QVideoWidget(QWidget *parent = nullptr)
virtual ~QVideoWidget() override
Qt::AspectRatioMode aspectRatioMode() const
bool isFullScreen() const
QVideoSink *videoSink() const

Reimplementierte öffentliche Funktionen

virtual QSize sizeHint() const override

Öffentliche Slots

void setAspectRatioMode(Qt::AspectRatioMode mode)
void setFullScreen(bool fullScreen)

Signale

void aspectRatioModeChanged(Qt::AspectRatioMode mode)
void fullScreenChanged(bool fullScreen)

Reimplementierte geschützte Funktionen

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

Detaillierte Beschreibung

Wenn ein QVideoWidget an ein QMediaPlayer oder QCamera angehängt wird, kann es die Video- oder Bildausgabe dieses Objekts anzeigen.

player = new QMediaPlayer;
player->setSource(QUrl("http://example.com/myclip1.mp4"));

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

videoWidget->show();
player->play();

Hinweis: An ein Medienobjekt kann immer nur ein einziger Anzeigeausgang angehängt werden.

Siehe auch QCamera, QMediaPlayer, und QGraphicsVideoItem.

Dokumentation der Eigenschaft

aspectRatioMode : Qt::AspectRatioMode

wie das Video in Bezug auf sein Seitenverhältnis skaliert wird.

Zugriffsfunktionen:

Qt::AspectRatioMode aspectRatioMode() const
void setAspectRatioMode(Qt::AspectRatioMode mode)

Benachrichtigungssignal:

void aspectRatioModeChanged(Qt::AspectRatioMode mode)

fullScreen : bool

Diese Eigenschaft gibt an, ob die Videoanzeige auf ein Fenster beschränkt ist oder im Vollbildmodus erfolgt.

Zugriffsfunktionen:

bool isFullScreen() const
void setFullScreen(bool fullScreen)

Benachrichtigungssignal:

void fullScreenChanged(bool fullScreen)

Dokumentation der Mitgliedsfunktionen

[explicit] QVideoWidget::QVideoWidget(QWidget *parent = nullptr)

Konstruiert ein neues Video-Widget.

Die Adresse parent wird an QWidget übergeben.

[override virtual noexcept] QVideoWidget::~QVideoWidget()

Zerstört ein Video-Widget.

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

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

Aktuelles Ereignis event. Gibt den Wert der Funktion der Basisklasse QWidget::event(QEvent *event) zurück.

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

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

Behandelt das Ausblenden event.

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

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

Behandelt die Verschiebung event.

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

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

Behandelt die Größenänderung event.

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

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

Behandelt die Show event.

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

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QWidget::sizeHint.

Gibt den Größenhinweis für das aktuelle Backend zurück, wenn es einen gibt, oder andernfalls den Größenhinweis von QWidget.

[invokable] QVideoSink *QVideoWidget::videoSink() const

Gibt die Instanz QVideoSink zurück.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.