QVideoWidget Class
Die Klasse „QVideoWidget“ stellt ein Widget bereit, das von einem Medienobjekt erzeugte Videos anzeigt. Mehr...
| Header: | #include <qvideowidget.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS MultimediaWidgets) target_link_libraries(mytarget PRIVATE Qt6::MultimediaWidgets) |
| qmake: | QT += multimediawidgets |
| Erbt von: | QWidget |
Eigenschaften
- aspectRatioMode : Qt::AspectRatioMode
- fullScreen : bool
Öffentliche Funktionen
| QVideoWidget(QWidget *parent = nullptr) | |
| virtual | ~QVideoWidget() override |
| Qt::AspectRatioMode | aspectRatioMode() const |
| bool | isFullScreen() const |
| QVideoSink * | videoSink() const |
Neu implementierte ö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) |
Neu implementierte 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 |
Ausführliche Beschreibung
Durch das Anfügen eines `QVideoWidget` an ein ` QMediaPlayer ` oder ` QCamera ` kann dieses die Video- oder Bildausgabe des jeweiligen 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 jeweils nur ein einziger Anzeigeausgang angehängt werden.
Warnung: QVideoWidget wird vom Plattform-Plugin „ eglfs “ nicht unterstützt.
Siehe auch QCamera, QMediaPlayer und QGraphicsVideoItem.
Dokumentation zu den Eigenschaften
aspectRatioMode : Qt::AspectRatioMode
Wie das Video entsprechend seinem 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) |
Notifier-Signal:
| void | fullScreenChanged(bool fullScreen) |
Dokumentation der Member-Funktionen
[explicit] QVideoWidget::QVideoWidget(QWidget *parent = nullptr)
Erstellt ein neues Video-Widget.
Das „ parent “ wird an „ QWidget “ übergeben.
[override virtual noexcept] QVideoWidget::~QVideoWidget()
Löst ein Video-Widget auf.
[override virtual protected] bool QVideoWidget::event(QEvent *event)
Implementiert: ` QWidget::event(QEvent *event)`.
Aktuelle Ereignis- event. Gibt den Wert der Funktion „ QWidget::event “ (QEvent *event) der Basisklasse zurück.
[override virtual protected] void QVideoWidget::hideEvent(QHideEvent *event)
Implementiert: QWidget::hideEvent(QHideEvent *event).
Behandelt das Ausblenden- event.
[override virtual protected] void QVideoWidget::moveEvent(QMoveEvent *event)
Umsetzt: QWidget::moveEvent(QMoveEvent *event).
Verarbeitet das Zug- event.
[override virtual protected] void QVideoWidget::resizeEvent(QResizeEvent *event)
Implementiert: QWidget::resizeEvent(QResizeEvent *event).
Behandelt das Resize- event.
[override virtual protected] void QVideoWidget::showEvent(QShowEvent *event)
Implementiert: QWidget::showEvent(QShowEvent *event).
Behandelt das Show- event.
[override virtual] QSize QVideoWidget::sizeHint() const
Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::sizeHint “ neu.
Gibt den Größenhinweis für das aktuelle Backend zurück, sofern vorhanden, andernfalls den Größenhinweis aus „ QWidget “.
[invokable] QVideoSink *QVideoWidget::videoSink() const
Gibt die Instanz „ QVideoSink “ zurück.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
© 2026 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.
