QVideoWidget Class
La classe QVideoWidget fournit un widget qui affiche la vidéo générée par un objet multimédia. En savoir plus...
| En-tête : | #include <qvideowidget.h> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS MultimediaWidgets) target_link_libraries(mytarget PRIVATE Qt6::MultimediaWidgets) |
| qmake : | QT += multimediawidgets |
| Hérite de : | 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 |
Slots 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'association d'un QVideoWidget à un objet de type « QMediaPlayer » ou « QCamera » permet à celui-ci 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: un seul périphérique d'affichage peut être associé à un objet multimédia à la fois.
Avertissement : QVideoWidget n’est pas pris en charge par le plugin de la plateforme eglfs.
Voir également QCamera, QMediaPlayer et QGraphicsVideoItem.
Documentation des propriétés
aspectRatioMode : Qt::AspectRatioMode
comment la vidéo est redimensionnée en fonction de son format d'image.
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 de la vidéo est limité à une fenêtre ou s'il est en plein écran.
Fonctions d'accès :
| bool | isFullScreen() const |
| void | setFullScreen(bool fullScreen) |
Signal de notification :
| void | fullScreenChanged(bool fullScreen) |
Documentation des fonctions membres
[explicit] QVideoWidget::QVideoWidget(QWidget *parent = nullptr)
Crée un nouveau widget vidéo.
L'parent est transmise à QWidget.
[override virtual noexcept] QVideoWidget::~QVideoWidget()
Supprime un widget vidéo.
[override virtual protected] bool QVideoWidget::event(QEvent *event)
Réimplémente : ` QWidget::event(QEvent *event)`.
Événement actuel event. Renvoie la valeur de la fonction QWidget::event(QEvent *event) de la classe de base.
[override virtual protected] void QVideoWidget::hideEvent(QHideEvent *event)
Réimplémente : QWidget::hideEvent(QHideEvent *event).
Gère l'event de masquage.
[override virtual protected] void QVideoWidget::moveEvent(QMoveEvent *event)
Réimplémente : QWidget::moveEvent(QMoveEvent *event).
Gère l'event de déplacement.
[override virtual protected] void QVideoWidget::resizeEvent(QResizeEvent *event)
Réimplémente : QWidget::resizeEvent(QResizeEvent *event).
Gère l'event de redimensionnement.
[override virtual protected] void QVideoWidget::showEvent(QShowEvent *event)
Réimplémente : QWidget::showEvent(QShowEvent *event).
Gère l'événement « show » de event.
[override virtual] QSize QVideoWidget::sizeHint() const
Réimplémente une fonction d'accès pour la propriété : QWidget::sizeHint.
Renvoie l'indication de taille pour le backend actuel, s'il y en a une, ou sinon l'indication de taille provenant de QWidget.
[invokable] QVideoSink *QVideoWidget::videoSink() const
Renvoie l'instance ` QVideoSink `.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis 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.
