Sur cette page

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)
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.