QVideoWidget Class
La classe QVideoWidget fournit un widget qui présente une vidéo produite par un objet média. Plus d'informations...
| En-tête : | #include <QVideoWidget> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS MultimediaWidgets)target_link_libraries(mytarget PRIVATE Qt6::MultimediaWidgets) |
| qmake : | QT += multimediawidgets |
| Héritages : | QWidget |
Propriétés
- aspectRatioMode : Qt::AspectRatioMode
- fullScreen : bool
Fonctions publiques
| QVideoWidget(QWidget *parent = nullptr) | |
| virtual | ~QVideoWidget() override |
| Qt::AspectRatioMode | aspectRatioMode() const |
| bool | isFullScreen() const |
| QVideoSink * | videoSink() const |
Fonctions publiques réimplémentées
| virtual QSize | sizeHint() const override |
Emplacements publics
| void | setAspectRatioMode(Qt::AspectRatioMode mode) |
| void | setFullScreen(bool fullScreen) |
Signaux
| void | aspectRatioModeChanged(Qt::AspectRatioMode mode) |
| void | fullScreenChanged(bool fullScreen) |
Fonctions protégées réimplémentées
| 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 |
Description détaillée
L'attachement d'un QVideoWidget à un QMediaPlayer ou QCamera lui permet d'afficher la sortie vidéo ou image de cet objet.
player = new QMediaPlayer; player->setSource(QUrl("http://example.com/myclip1.mp4")); videoWidget = new QVideoWidget; player->setVideoOutput(videoWidget); videoWidget->show(); player->play();
Remarque: une seule sortie d'affichage peut être attachée à un objet média à la fois.
Attention : QVideoWidget n'est pas pris en charge par le plugin de plateforme eglfs.
Voir également QCamera, QMediaPlayer, et QGraphicsVideoItem.
Documentation sur les propriétés
aspectRatioMode : Qt::AspectRatioMode
la façon dont la vidéo est mise à l'échelle par rapport à son rapport hauteur/largeur.
Fonctions d'accès :
| Qt::AspectRatioMode | aspectRatioMode() const |
| void | setAspectRatioMode(Qt::AspectRatioMode mode) |
Signal de notification :
| void | aspectRatioModeChanged(Qt::AspectRatioMode mode) |
fullScreen : bool
Cette propriété indique si l'affichage vidéo est limité à une fenêtre ou s'il est plein écran.
Fonctions d'accès :
| bool | isFullScreen() const |
| void | setFullScreen(bool fullScreen) |
Signal Notifier :
| void | fullScreenChanged(bool fullScreen) |
Member Function Documentation
[explicit] QVideoWidget::QVideoWidget(QWidget *parent = nullptr)
Construit un nouveau widget vidéo.
L'adresse parent est transmise à QWidget.
[override virtual noexcept] QVideoWidget::~QVideoWidget()
Détruit un widget vidéo.
[override virtual protected] bool QVideoWidget::event(QEvent *event)
Réimplémente : QWidget::event(QEvent *event).
Événement en cours event. Renvoie la valeur de la fonction de la classe de base QWidget::event(QEvent *event).
[override virtual protected] void QVideoWidget::hideEvent(QHideEvent *event)
Réimplémente : QWidget::hideEvent(QHideEvent *event).
Gère l'événement de masquage event.
[override virtual protected] void QVideoWidget::moveEvent(QMoveEvent *event)
Réimplémente : QWidget::moveEvent(QMoveEvent *event).
Gère le déplacement event.
[override virtual protected] void QVideoWidget::resizeEvent(QResizeEvent *event)
Réimplémente : QWidget::resizeEvent(QResizeEvent *event).
Gère le redimensionnement event.
[override virtual protected] void QVideoWidget::showEvent(QShowEvent *event)
Réimplémente : QWidget::showEvent(QShowEvent *event).
Gère l'affichage event.
[override virtual] QSize QVideoWidget::sizeHint() const
Réimplémente une fonction d'accès pour la propriété : QWidget::sizeHint.
Renvoie l'indice de taille pour le back-end actuel, s'il y en a un, ou sinon l'indice de taille de QWidget.
[invokable] QVideoSink *QVideoWidget::videoSink() const
Renvoie l'instance QVideoSink.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir 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.
