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) |
Elementos no miembros relacionados
| 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.