En esta página

QMediaTimeRange Class

La clase QMediaTimeRange representa un conjunto de cero o más intervalos de tiempo disjuntos. Más información...

Cabecera: #include <QMediaTimeRange>
CMake: find_package(Qt6 REQUIRED COMPONENTS Multimedia)
target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake: QT += multimedia

Nota: Todas las funciones de esta clase son reentrantes.

Tipos públicos

struct Interval

Funciones públicas

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)

Descripción detallada

Los métodos earliestTime(), latestTime(), intervals() y isEmpty() se utilizan para obtener información sobre el intervalo de tiempo actual.

Los métodos addInterval(), removeInterval() y clear() se utilizan para modificar el intervalo de tiempo actual.

Al añadir o eliminar intervalos del intervalo de tiempo, los intervalos existentes dentro de dicho intervalo pueden ampliarse, recortarse, eliminarse, fusionarse o dividirse para garantizar que todos los intervalos dentro del intervalo de tiempo sigan siendo distintos y disjuntos. Por consiguiente, todos los intervalos añadidos o eliminados de un intervalo de tiempo deben ser « normal ».

Véase también QMediaTimeRange::Interval.

Documentación de funciones miembro

QMediaTimeRange::QMediaTimeRange()

Crea un intervalo de tiempo vacío.

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

Crea un intervalo de tiempo que contiene un intervalo inicial, interval.

Si interval no es un « normal », el intervalo de tiempo resultante estará vacío.

Véase también addInterval().

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

Crea un intervalo de tiempo que contiene un intervalo inicial comprendido entre start y end, ambos inclusive.

Si el intervalo no es normal, el intervalo de tiempo resultante estará vacío.

Véase también addInterval().

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

Crea un intervalo de tiempo copiando otro intervalo de tiempo range.

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

Crea un intervalo de tiempo a partir de other.

[noexcept] QMediaTimeRange::~QMediaTimeRange()

Destructor.

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

Añade el « interval » especificado al intervalo de tiempo.

No es válido añadir intervalos que no sean « normal »; estos se ignorarán.

Si el intervalo especificado es adyacente a intervalos existentes dentro del intervalo de tiempo, o se solapa con ellos, dichos intervalos se fusionarán.

Esta operación requiere un tiempo lineal.

Véase también removeInterval().

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

Añade el intervalo especificado por start y end al intervalo de tiempo.

Esta es una función sobrecargada.

Véase también addInterval().

void QMediaTimeRange::addTimeRange(const QMediaTimeRange &range)

Añade cada uno de los intervalos de range a este intervalo de tiempo.

Equivale a llamar a ` addInterval()` para cada intervalo de ` range`.

void QMediaTimeRange::clear()

Elimina todos los intervalos del intervalo de tiempo.

Véase también removeInterval().

bool QMediaTimeRange::contains(qint64 time) const

Devuelve «true» si el « time » especificado se encuentra dentro del intervalo de tiempo.

qint64 QMediaTimeRange::earliestTime() const

Devuelve la hora más temprana dentro del intervalo de tiempo.

En el caso de intervalos de tiempo vacíos, este valor es igual a cero.

Véase también latestTime().

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

Devuelve la lista de intervalos que abarca este intervalo de tiempo.

bool QMediaTimeRange::isContinuous() const

Devuelve «true» si el intervalo de tiempo está formado por un intervalo continuo. Es decir, hay un intervalo o menos que no se solapan dentro del intervalo de tiempo.

bool QMediaTimeRange::isEmpty() const

Devuelve «true» si no hay intervalos dentro del intervalo de tiempo.

Véase también intervals().

qint64 QMediaTimeRange::latestTime() const

Devuelve la hora más reciente dentro del intervalo de tiempo.

En el caso de intervalos de tiempo vacíos, este valor es igual a cero.

Véase también earliestTime().

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

Elimina el « interval » especificado del intervalo de tiempo.

La eliminación de intervalos que no sean « normal » no es válida y se ignorará.

Los intervalos comprendidos en el rango de tiempo se recortarán, dividirán o eliminarán de tal forma que ningún intervalo de dicho rango incluya ninguna parte del intervalo de destino.

Esta operación requiere un tiempo lineal.

Véase también addInterval().

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

Elimina del intervalo de tiempo el intervalo especificado en start y end.

Esta es una función sobrecargada.

Véase también removeInterval().

void QMediaTimeRange::removeTimeRange(const QMediaTimeRange &range)

Elimina cada uno de los intervalos de range de este intervalo de tiempo.

Equivale a llamar a ` removeInterval()` para cada intervalo de ` range`.

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

Intercambia la instancia actual con la de other.

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

Añade cada intervalo de « other » al intervalo de tiempo y devuelve el resultado.

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

Añade el ` interval ` especificado al intervalo de tiempo y devuelve el resultado.

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

Elimina cada intervalo de other del intervalo de tiempo y devuelve el resultado.

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

Elimina el « interval » especificado del intervalo de tiempo y devuelve el resultado.

[noexcept] QMediaTimeRange &QMediaTimeRange::operator=(QMediaTimeRange &&other)

Sitúa « other » en este intervalo de tiempo.

[noexcept] QMediaTimeRange &QMediaTimeRange::operator=(const QMediaTimeRange &other)

Toma una copia del intervalo de tiempo de « other » y devuelve la propia función.

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

Establece el intervalo de tiempo en un único intervalo continuo: interval.

Relacionado: No miembros

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

Devuelve «true» si uno o más intervalos de lhs no están presentes en rhs.

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

Devuelve un intervalo de tiempo que contiene la unión entre r1 y r2.

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

Devuelve un intervalo de tiempo que contiene el valor de « r2 » restado de « r1 ».

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

Devuelve «true» si todos los intervalos de lhs están presentes en 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.