QFont::Tag Struct
struct QFont::TagQFont::Tag 유형은 고급 글꼴 기능에 대한 액세스를 제공합니다. 더 보기...
이 구조체는 Qt 6.7에서 도입되었습니다.
공개 함수
| Tag() | |
| Tag(const char (&str)[N]) | |
| bool | isValid() const |
| QByteArray | toString() const |
| quint32 | value() const |
정적 공용 멤버
| std::optional<QFont::Tag> | fromString(QAnyStringView view) |
| std::optional<QFont::Tag> | fromValue(quint32 value) |
관련 비회원
| Qt::strong_ordering | compareThreeWay(const QFont::Tag &lhs, const QFont::Tag &rhs) |
| bool | comparesEqual(const QFont::Tag &lhs, const QFont::Tag &rhs) |
| size_t | qHash(QFont::Tag key, size_t seed = 0) |
| QDataStream & | operator<<(QDataStream &, QFont::Tag) |
| QDataStream & | operator>>(QDataStream &, QFont::Tag &) |
상세 설명
QFont 텍스트를 형성할 때 고급 기능에 대한 액세스를 제공합니다. 기능은 태그로 정의되며, 태그는 4자 문자열 또는 32비트 정수 값으로 표현될 수 있습니다. 이 타입은 이러한 태그를 타입 안전하게 표현합니다. 이 타입은 4자, 8비트 문자열 리터럴이나 이에 상응하는 32비트 정수 값으로 생성할 수 있습니다. 더 짧거나 더 긴 문자열 리터럴을 사용하면 컴파일 시 오류가 발생합니다.
QFont font;
// Correct
font.setFeature("frac");
// Wrong - won't compile
font.setFeature("fraction");
// Wrong - will produce runtime warning and fail
font.setFeature(u"fraction"_s);명명된 생성자를 사용하면 32비트 정수나 문자열 값으로 태그를 생성할 수 있으며, 입력이 유효하지 않을 경우 ` std::nullopt `를 반환합니다.
QFont::setFeature() 및 QFont::featureTags()도 참조하십시오 .
멤버 함수 설명서
[constexpr noexcept default] Tag::Tag()
무효한 태그를 생성하는 기본 생성자.
[constexpr noexcept] template <size_t N> Tag::Tag(const char (&str)[N])
문자열 리터럴( str)을 사용하여 태그를 생성합니다. 리터럴의 길이는 정확히 4자여야 합니다.
font.setFeature("frac", 1);fromString() 및 fromValue()도 참조하십시오 .
[static noexcept] std::optional<QFont::Tag> Tag::fromString(QAnyStringView view)
view 에 지정된 문자열로 구성된 태그를 반환합니다. 이 문자열의 길이는 정확히 4자여야 합니다.
입력 문자열의 길이가 4자가 아니거나, 생성된 태그가 유효하지 않은 경우 std::nullopt 를 반환합니다.
isValid() 및 fromValue()도 참조하십시오 .
[static constexpr noexcept] std::optional<QFont::Tag> Tag::fromValue(quint32 value)
value 를 기반으로 생성된 태그를 반환하며, 생성된 태그가 유효하지 않은 경우 std::nullopt 를 반환합니다.
isValid()도 참조하십시오 .
[constexpr noexcept] bool Tag::isValid() const
태그가 유효한지 여부를 반환합니다. 태그의 값이 0이 아닐 경우 해당 태그는 유효한 것으로 간주됩니다.
value(), fromValue(), fromString()도 참조하십시오 .
QByteArray Tag::toString() const
이 태그를 문자열로 표현한 것을 바이트 배열로 반환합니다.
fromString()도 참조하십시오 .
[constexpr noexcept] quint32 Tag::value() const
이 태그의 수치 값을 반환합니다.
관련 비회원
[constexpr noexcept] Qt::strong_ordering compareThreeWay(const QFont::Tag &lhs, const QFont::Tag &rhs)
[constexpr noexcept] bool comparesEqual(const QFont::Tag &lhs, const QFont::Tag &rhs)
lhs 와 rhs 를 비교하여 값의 동일성과 순서를 확인하십시오.
[constexpr noexcept] size_t qHash(QFont::Tag key, size_t seed = 0)
seed 를 계산의 시드로 사용하여 key 에 대한 해시 값을 반환합니다.
QDataStream &operator<<(QDataStream &, QFont::Tag)
QDataStream &operator>>(QDataStream &, QFont::Tag &)
QFont::Tag 용 데이터 스트림 연산자.
© 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.
