이 페이지에서

QMediaTimeRange Class

QMediaTimeRange 클래스는 0개 이상의 서로 겹치지 않는 시간 구간 집합을 나타냅니다. 더 보기...

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

참고: 이 클래스의 모든 함수는 재입력 가능합니다.

공개 타입

struct Interval

공개 함수

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)

상세 설명

earliestTime(), latestTime(), intervals() 및 isEmpty() 메서드는 현재 시간 범위에 대한 정보를 가져오는 데 사용됩니다.

addInterval(), removeInterval() 및 clear() 메서드는 현재 시간 범위를 수정하는 데 사용됩니다.

시간 범위에서 구간을 추가하거나 제거할 때, 해당 범위 내의 기존 구간은 확장, 잘라내기, 삭제, 병합 또는 분할될 수 있으며, 이는 시간 범위 내의 모든 구간이 서로 구별되고 겹치지 않도록 하기 위함입니다. 따라서 시간 범위에 추가되거나 제거되는 모든 구간은 normal 여야 합니다.

QMediaTimeRange::Interval도 참조하십시오 .

멤버 함수 문서

QMediaTimeRange::QMediaTimeRange()

빈 시간 범위를 생성합니다.

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

초기 구간인 ` interval`을 포함하는 시간 범위를 생성합니다.

interval 가 normal 가 아닌 경우, 결과 시간 범위는 비어 있게 됩니다.

addInterval()도 참조하십시오 .

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

start 부터 end 까지(양쪽 끝 포함)의 초기 구간을 포함하는 시간 범위를 생성합니다.

간격이 normal 가 아닌 경우, 결과 시간 범위는 비어 있게 됩니다.

addInterval()도 참조하십시오 .

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

다른 시간 range 을 복사하여 시간 범위를 생성합니다.

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

other 에서 이동하여 시간 범위를 생성합니다.

[noexcept] QMediaTimeRange::~QMediaTimeRange()

소멸자.

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

지정된 interval 를 시간 범위에 추가합니다.

normal 가 아닌 간격을 추가하는 것은 유효하지 않으며, 무시됩니다.

지정된 간격이 시간 범위 내의 기존 간격과 인접하거나 겹치는 경우, 해당 간격들은 병합됩니다.

이 작업은 선형 시간을 소요합니다.

removeInterval()도 참조하십시오 .

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

start 와 end 로 지정된 간격을 시간 범위에 추가합니다.

이 함수는 오버로드된 함수입니다.

addInterval()도 참조하십시오 .

void QMediaTimeRange::addTimeRange(const QMediaTimeRange &range)

range 에 포함된 각 구간을 이 시간 범위에 추가합니다.

range 에 정의된 각 간격에 대해 addInterval()을 호출하는 것과 동일합니다.

void QMediaTimeRange::clear()

지정된 시간 범위에서 모든 구간을 제거합니다.

removeInterval()도 참조하십시오 .

bool QMediaTimeRange::contains(qint64 time) const

지정된 time 가 시간 범위 내에 있는 경우 true를 반환합니다.

qint64 QMediaTimeRange::earliestTime() const

지정된 시간 범위 내에서 가장 이른 시간을 반환합니다.

시간 범위가 비어 있는 경우, 이 값은 0과 같습니다.

latestTime()도 참조하십시오 .

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

이 시간 범위에 해당하는 구간 목록을 반환합니다.

bool QMediaTimeRange::isContinuous() const

시간 범위가 연속적인 구간으로 구성되어 있으면 true를 반환합니다. 즉, 해당 시간 범위 내에 서로 겹치지 않는 구간이 하나 이하로 존재합니다.

bool QMediaTimeRange::isEmpty() const

지정된 시간 범위 내에 구간이 없으면 true를 반환합니다.

intervals()도 참조하십시오 .

qint64 QMediaTimeRange::latestTime() const

지정된 시간 범위 내에서 가장 최근의 시간을 반환합니다.

시간 범위가 비어 있는 경우, 이 값은 0과 같습니다.

earliestTime()도 참조하십시오 .

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

지정된 interval 을 시간 범위에서 제거합니다.

normal 에 속하지 않는 구간을 제거하는 것은 유효하지 않으며, 무시됩니다.

시간 범위 내의 간격은 대상 간격의 일부를 포함하지 않도록 잘라내거나, 분할하거나, 삭제됩니다.

이 연산은 선형 시간을 소요합니다.

addInterval()도 참조하십시오 .

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

start 및 end 로 지정된 구간을 시간 범위에서 제거합니다.

이 함수는 오버로드된 함수입니다.

removeInterval()도 참조하십시오 .

void QMediaTimeRange::removeTimeRange(const QMediaTimeRange &range)

range 에 있는 각 구간을 이 시간 범위에서 제거합니다.

이는 range 에 있는 각 구간마다 removeInterval()를 호출하는 것과 동일합니다.

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

현재 인스턴스를 ` other`과 교체합니다.

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

other 에 포함된 각 구간을 시간 범위에 추가하고 그 결과를 반환합니다.

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

지정된 interval 를 시간 범위에 추가하고 그 결과를 반환합니다.

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

other 에 지정된 각 구간을 시간 범위에서 제거하고 그 결과를 반환합니다.

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

지정된 interval 를 시간 범위에서 제거하고 그 결과를 반환합니다.

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

other 를 이 시간 범위로 이동시킵니다.

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

other 의 시간 범위를 복사한 후, 이를 반환합니다.

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

시간 범위를 단일 연속 구간( interval)으로 설정합니다.

관련 비회원

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

lhs 에 포함된 구간 중 하나 이상이 rhs 에 존재하지 않는 경우 true를 반환합니다.

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

r1 과 r2 의 합집합을 포함하는 시간 범위를 반환합니다.

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

` r2 `에서 ` r1`을 뺀 시간 범위를 반환합니다.

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

lhs 에 포함된 모든 구간이 rhs 에 포함되어 있으면 true를 반환합니다.

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