QMediaTimeRange Class
La classe QMediaTimeRange représente un ensemble composé de zéro ou plusieurs intervalles de temps disjoints. En savoir plus...
| En-tête : | #include <QMediaTimeRange> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake : | QT += multimedia |
Remarque : toutes les fonctions de cette classe sont réentrantes.
Types publics
| struct | Interval |
Fonctions publiques
| QMediaTimeRange() | |
| QMediaTimeRange(const QMediaTimeRange::Interval &interval) | |
| QMediaTimeRange(qint64 start, qint64 end) | |
| QMediaTimeRange(const QMediaTimeRange &range) | |
| QMediaTimeRange(QMediaTimeRange &&other) | |
| ~QMediaTimeRange() | |
| void | addInterval(const QMediaTimeRange::Interval &interval) |
| void | addInterval(qint64 start, qint64 end) |
| void | addTimeRange(const QMediaTimeRange &range) |
| void | clear() |
| bool | contains(qint64 time) const |
| qint64 | earliestTime() const |
| QList<QMediaTimeRange::Interval> | intervals() const |
| bool | isContinuous() const |
| bool | isEmpty() const |
| qint64 | latestTime() const |
| void | removeInterval(const QMediaTimeRange::Interval &interval) |
| void | removeInterval(qint64 start, qint64 end) |
| void | removeTimeRange(const QMediaTimeRange &range) |
| void | swap(QMediaTimeRange &other) |
| QMediaTimeRange & | operator+=(const QMediaTimeRange &other) |
| QMediaTimeRange & | operator+=(const QMediaTimeRange::Interval &interval) |
| QMediaTimeRange & | operator-=(const QMediaTimeRange &other) |
| QMediaTimeRange & | operator-=(const QMediaTimeRange::Interval &interval) |
| QMediaTimeRange & | operator=(QMediaTimeRange &&other) |
| QMediaTimeRange & | operator=(const QMediaTimeRange &other) |
| QMediaTimeRange & | operator=(const QMediaTimeRange::Interval &interval) |
Éléments non membres associés
| bool | operator!=(const QMediaTimeRange &lhs, const QMediaTimeRange &rhs) |
| QMediaTimeRange | operator+(const QMediaTimeRange &r1, const QMediaTimeRange &r2) |
| QMediaTimeRange | operator-(const QMediaTimeRange &r1, const QMediaTimeRange &r2) |
| bool | operator==(const QMediaTimeRange &lhs, const QMediaTimeRange &rhs) |
Description détaillée
Les méthodes earliestTime(), latestTime(), intervals() et isEmpty() permettent d'obtenir des informations sur la plage temporelle actuelle.
Les méthodes addInterval(), removeInterval() et clear() permettent de modifier l'intervalle de temps actuel.
Lors de l’ajout ou de la suppression d’intervalles dans la plage temporelle, les intervalles existants au sein de cette plage peuvent être étendus, raccourcis, supprimés, fusionnés ou divisés afin de garantir que tous les intervalles de la plage temporelle restent distincts et disjoints. Par conséquent, tous les intervalles ajoutés ou supprimés d’une plage temporelle doivent être de type ` normal`.
Voir également QMediaTimeRange::Interval.
Documentation des fonctions membres
QMediaTimeRange::QMediaTimeRange()
Crée une plage temporelle vide.
QMediaTimeRange::QMediaTimeRange(const QMediaTimeRange::Interval &interval)
Crée une plage temporelle contenant un intervalle initial, interval.
Si interval n'est pas normal, la plage temporelle résultante sera vide.
Voir également addInterval().
[explicit] QMediaTimeRange::QMediaTimeRange(qint64 start, qint64 end)
Crée une plage temporelle contenant un intervalle initial allant de start à end inclus.
Si l’intervalle n’est pas normal, la plage de temps résultante sera vide.
Voir également addInterval().
[noexcept] QMediaTimeRange::QMediaTimeRange(const QMediaTimeRange &range)
Crée une plage de dates en copiant une autre plage de dates range.
[constexpr noexcept default] QMediaTimeRange::QMediaTimeRange(QMediaTimeRange &&other)
Crée une plage de dates à partir de other.
[noexcept] QMediaTimeRange::~QMediaTimeRange()
Destructeur.
void QMediaTimeRange::addInterval(const QMediaTimeRange::Interval &interval)
Ajoute l'interval e spécifiée à la plage horaire.
L'ajout d'normal s qui ne sont pas des s n'est pas valide et sera ignoré.
Si l'xml-ph-0000@deepl.internal spécifié est adjacent à des intervalles existants au sein de la plage temporelle ou s'il les chevauche, ces intervalles seront fusionnés.
Cette opération s'effectue en temps linéaire.
Voir aussi removeInterval().
void QMediaTimeRange::addInterval(qint64 start, qint64 end)
Ajoute l'intervalle spécifié par start et end à la plage horaire.
Il s'agit d'une fonction surchargée.
Voir également addInterval().
void QMediaTimeRange::addTimeRange(const QMediaTimeRange &range)
Ajoute chacun des intervalles de range à cette plage horaire.
Cela revient à appeler la fonction ` addInterval()` pour chaque intervalle de ` range`.
void QMediaTimeRange::clear()
Supprime tous les intervalles de la plage horaire.
Voir également removeInterval().
bool QMediaTimeRange::contains(qint64 time) const
Renvoie « true » si l’ time e spécifiée se situe dans l’intervalle de temps.
qint64 QMediaTimeRange::earliestTime() const
Renvoie l'heure la plus précoce comprise dans l'intervalle de temps.
Pour les plages horaires vides, cette valeur est égale à zéro.
Voir également latestTime().
QList<QMediaTimeRange::Interval> QMediaTimeRange::intervals() const
Renvoie la liste des intervalles compris dans cette plage horaire.
bool QMediaTimeRange::isContinuous() const
Renvoie « true » si la plage temporelle est constituée d'un intervalle continu. Autrement dit, si cette plage temporelle ne contient qu'un seul intervalle disjoint, voire aucun.
bool QMediaTimeRange::isEmpty() const
Renvoie « true » s'il n'y a aucun intervalle dans la plage de temps.
Voir aussi intervals().
qint64 QMediaTimeRange::latestTime() const
Renvoie l'heure la plus récente comprise dans l'intervalle de temps.
Pour les plages horaires vides, cette valeur est égale à zéro.
Voir également earliestTime().
void QMediaTimeRange::removeInterval(const QMediaTimeRange::Interval &interval)
Supprime les « interval » spécifiés de la plage horaire.
La suppression d'intervalles qui ne sont pas des « normal s » n'est pas autorisée et sera ignorée.
Les intervalles se trouvant dans la plage temporelle seront raccourcis, fractionnés ou supprimés de manière à ce qu’aucun intervalle de cette plage ne recoupe l’xml-ph-0000@deepl.internal cible.
Cette opération s'effectue en temps linéaire.
Voir aussi addInterval().
void QMediaTimeRange::removeInterval(qint64 start, qint64 end)
Supprime de l'intervalle de temps l'intervalle spécifié par start et end.
Il s'agit d'une fonction surchargée.
Voir également removeInterval().
void QMediaTimeRange::removeTimeRange(const QMediaTimeRange &range)
Supprime chacun des intervalles de range de cette plage horaire.
Cela revient à appeler la fonction ` removeInterval()` pour chaque intervalle de ` range`.
[noexcept] void QMediaTimeRange::swap(QMediaTimeRange &other)
Permute l'instance actuelle avec celle de other.
QMediaTimeRange &QMediaTimeRange::operator+=(const QMediaTimeRange &other)
Ajoute chaque intervalle de la liste « other » à la plage de temps et renvoie le résultat.
QMediaTimeRange &QMediaTimeRange::operator+=(const QMediaTimeRange::Interval &interval)
Ajoute l'interval ion spécifiée à la plage de temps et renvoie le résultat.
QMediaTimeRange &QMediaTimeRange::operator-=(const QMediaTimeRange &other)
Supprime chaque intervalle défini dans ` other ` de la plage de temps et renvoie le résultat.
QMediaTimeRange &QMediaTimeRange::operator-=(const QMediaTimeRange::Interval &interval)
Supprime l'interval ion spécifiée de la plage de temps et renvoie le résultat.
[noexcept] QMediaTimeRange &QMediaTimeRange::operator=(QMediaTimeRange &&other)
Déplace « other » dans cette plage horaire.
[noexcept] QMediaTimeRange &QMediaTimeRange::operator=(const QMediaTimeRange &other)
Récupère une copie de la plage horaire de l'other, puis renvoie cette même instance.
QMediaTimeRange &QMediaTimeRange::operator=(const QMediaTimeRange::Interval &interval)
Définit la plage horaire sur un seul intervalle continu : interval.
Concepts connexes pour les non-membres
bool operator!=(const QMediaTimeRange &lhs, const QMediaTimeRange &rhs)
Renvoie « true » si un ou plusieurs intervalles de lhs ne figurent pas dans rhs.
QMediaTimeRange operator+(const QMediaTimeRange &r1, const QMediaTimeRange &r2)
Renvoie une plage de dates correspondant à l'union des plages r1 et r2.
QMediaTimeRange operator-(const QMediaTimeRange &r1, const QMediaTimeRange &r2)
Renvoie une plage de temps correspondant à la différence entre r2 et r1.
bool operator==(const QMediaTimeRange &lhs, const QMediaTimeRange &rhs)
Renvoie « true » si tous les intervalles de lhs figurent également dans rhs.
© 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.