Sur cette page

QMediaTimeRange Class

La classe QMediaTimeRange représente un ensemble de zéro ou plusieurs intervalles de temps disjoints. Plus d'informations...

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 l'intervalle de temps actuel.

Les méthodes addInterval(), removeInterval() et clear() sont utilisées pour modifier l'intervalle de temps actuel.

Lors de l'ajout ou de la suppression d'intervalles dans l'intervalle de temps, les intervalles existants dans l'intervalle peuvent être étendus, réduits, supprimés, fusionnés ou divisés afin de garantir que tous les intervalles dans l'intervalle de temps restent distincts et disjoints. Par conséquent, tous les intervalles ajoutés ou supprimés d'un intervalle de temps doivent être normal.

Voir également QMediaTimeRange::Interval.

Documentation sur les fonctions membres

QMediaTimeRange::QMediaTimeRange()

Construit un intervalle de temps vide.

QMediaTimeRange::QMediaTimeRange(const QMediaTimeRange::Interval &interval)

Construit un intervalle de temps qui contient un intervalle initial, interval.

Si interval n'est pas normal, l'intervalle de temps résultant sera vide.

Voir aussi addInterval().

[explicit] QMediaTimeRange::QMediaTimeRange(qint64 start, qint64 end)

Construit un intervalle de temps qui contient un intervalle initial de start à end inclus.

Si l'intervalle n'est pas normal, l'intervalle résultant sera vide.

Voir aussi addInterval().

[noexcept] QMediaTimeRange::QMediaTimeRange(const QMediaTimeRange &range)

Construit un intervalle de temps en copiant un autre intervalle de temps range.

[constexpr noexcept] QMediaTimeRange::QMediaTimeRange(QMediaTimeRange &&other)

Construit un intervalle de temps en se déplaçant de other.

[noexcept] QMediaTimeRange::~QMediaTimeRange()

Destructeur.

void QMediaTimeRange::addInterval(const QMediaTimeRange::Interval &interval)

Ajoute l'intervalle de temps spécifié interval à l'intervalle de temps.

L'ajout d'intervalles qui ne sont pas normal n'est pas valable et sera ignoré.

Si l'intervalle spécifié est adjacent à des intervalles existants dans l'intervalle de temps ou les chevauche, ces intervalles seront fusionnés.

Cette opération prend un temps linéaire.

Voir également removeInterval().

void QMediaTimeRange::addInterval(qint64 start, qint64 end)

Ajoute l'intervalle spécifié par start et end à l'intervalle de temps.

Il s'agit d'une fonction surchargée.

Voir aussi addInterval().

void QMediaTimeRange::addTimeRange(const QMediaTimeRange &range)

Ajoute chacun des intervalles de range à cet intervalle de temps.

Cela équivaut à appeler addInterval() pour chaque intervalle de range.

void QMediaTimeRange::clear()

Supprime tous les intervalles de l'intervalle de temps.

Voir également removeInterval().

bool QMediaTimeRange::contains(qint64 time) const

Renvoie un résultat positif si l'adresse time spécifiée est comprise dans l'intervalle de temps.

qint64 QMediaTimeRange::earliestTime() const

Renvoie l'heure la plus ancienne de la plage horaire.

Pour les plages de temps vides, cette valeur est égale à zéro.

Voir aussi latestTime().

QList<QMediaTimeRange::Interval> QMediaTimeRange::intervals() const

Renvoie la liste des intervalles couverts par cet intervalle de temps.

bool QMediaTimeRange::isContinuous() const

Retourne vrai si l'intervalle de temps consiste en un intervalle continu. C'est-à-dire qu'il existe un ou plusieurs intervalles disjoints dans l'intervalle de temps.

bool QMediaTimeRange::isEmpty() const

Retourne vrai s'il n'y a pas d'intervalles dans l'intervalle de temps.

Voir également intervals().

qint64 QMediaTimeRange::latestTime() const

Renvoie l'heure la plus récente dans l'intervalle de temps.

Pour les plages de temps vides, cette valeur est égale à zéro.

Voir aussi earliestTime().

void QMediaTimeRange::removeInterval(const QMediaTimeRange::Interval &interval)

Supprime l'intervalle de temps spécifié interval.

La suppression d'intervalles qui ne sont pas normal n'est pas valable et sera ignorée.

Les intervalles de l'intervalle de temps seront réduits, divisés ou supprimés de manière à ce qu'aucun intervalle de l'intervalle de temps ne comprenne une partie de l'intervalle cible.

Cette opération prend un temps linéaire.

Voir également addInterval().

void QMediaTimeRange::removeInterval(qint64 start, qint64 end)

Supprime l'intervalle spécifié par start et end de l'intervalle de temps.

Il s'agit d'une fonction surchargée.

Voir aussi removeInterval().

void QMediaTimeRange::removeTimeRange(const QMediaTimeRange &range)

Supprime chacun des intervalles de range de cet intervalle de temps.

Cela équivaut à appeler removeInterval() pour chaque intervalle de range.

[noexcept] void QMediaTimeRange::swap(QMediaTimeRange &other)

Remplace l'instance actuelle par l'instance other.

QMediaTimeRange &QMediaTimeRange::operator+=(const QMediaTimeRange &other)

Ajoute chaque intervalle dans other à l'intervalle de temps et renvoie le résultat.

QMediaTimeRange &QMediaTimeRange::operator+=(const QMediaTimeRange::Interval &interval)

Ajoute l'adresse interval spécifiée à l'intervalle de temps et renvoie le résultat.

QMediaTimeRange &QMediaTimeRange::operator-=(const QMediaTimeRange &other)

Supprime chaque intervalle dans other de l'intervalle de temps et renvoie le résultat.

QMediaTimeRange &QMediaTimeRange::operator-=(const QMediaTimeRange::Interval &interval)

Supprime l'adresse interval spécifiée de l'intervalle 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)

Prend une copie de l'intervalle de temps other et se renvoie lui-même.

QMediaTimeRange &QMediaTimeRange::operator=(const QMediaTimeRange::Interval &interval)

Définit l'intervalle de temps à un seul intervalle continu, interval.

Non-membres apparentés

bool operator!=(const QMediaTimeRange &lhs, const QMediaTimeRange &rhs)

Retourne vrai si un ou plusieurs intervalles dans lhs ne sont pas présents dans rhs.

QMediaTimeRange operator+(const QMediaTimeRange &r1, const QMediaTimeRange &r2)

Renvoie un intervalle de temps contenant l'union entre r1 et r2.

QMediaTimeRange operator-(const QMediaTimeRange &r1, const QMediaTimeRange &r2)

Renvoie un intervalle de temps contenant r2 soustrait de r1.

bool operator==(const QMediaTimeRange &lhs, const QMediaTimeRange &rhs)

Retourne vrai si tous les intervalles de lhs sont présents 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.