이 페이지에서

QNdefNfcSmartPosterRecord Class

QNdefNfcSmartPosterRecord 클래스는 NFC RTD-SmartPoster를 제공합니다. 더 보기...

헤더: #include <QNdefNfcSmartPosterRecord>
CMake: find_package(Qt6 REQUIRED COMPONENTS Nfc)
target_link_libraries(mytarget PRIVATE Qt6::Nfc)
qmake: QT += nfc
다음부터: Qt 5.2
상속: QNdefRecord

공개 유형

enum Action { UnspecifiedAction, DoAction, SaveAction, EditAction }

공개 함수

QNdefNfcSmartPosterRecord()
QNdefNfcSmartPosterRecord(const QNdefRecord &other)
QNdefNfcSmartPosterRecord(const QNdefNfcSmartPosterRecord &other)
~QNdefNfcSmartPosterRecord()
QNdefNfcSmartPosterRecord::Action action() const
void addIcon(const QNdefNfcIconRecord &icon)
void addIcon(const QByteArray &type, const QByteArray &data)
bool addTitle(const QNdefNfcTextRecord &text)
bool addTitle(const QString &text, const QString &locale, QNdefNfcTextRecord::Encoding encoding)
bool hasAction() const
bool hasIcon(const QByteArray &mimetype = QByteArray()) const
bool hasSize() const
bool hasTitle(const QString &locale = QString()) const
bool hasTypeInfo() const
QByteArray icon(const QByteArray &mimetype = QByteArray()) const
qsizetype iconCount() const
QNdefNfcIconRecord iconRecord(qsizetype index) const
QList<QNdefNfcIconRecord> iconRecords() const
bool removeIcon(const QByteArray &type)
bool removeIcon(const QNdefNfcIconRecord &icon)
bool removeTitle(const QNdefNfcTextRecord &text)
bool removeTitle(const QString &locale)
void setAction(QNdefNfcSmartPosterRecord::Action act)
void setIcons(const QList<QNdefNfcIconRecord> &icons)
void setSize(quint32 size)
void setTitles(const QList<QNdefNfcTextRecord> &titles)
void setTypeInfo(const QString &type)
void setUri(const QNdefNfcUriRecord &url)
void setUri(const QUrl &url)
quint32 size() const
QString title(const QString &locale = QString()) const
qsizetype titleCount() const
QNdefNfcTextRecord titleRecord(qsizetype index) const
QList<QNdefNfcTextRecord> titleRecords() const
QString typeInfo() const
QUrl uri() const
QNdefNfcUriRecord uriRecord() const
QNdefNfcSmartPosterRecord &operator=(const QNdefNfcSmartPosterRecord &other)

상세 설명

RTD-SmartPoster는 Smart Poster를 캡슐화합니다.

멤버 유형 설명

enum QNdefNfcSmartPosterRecord::Action

이 열거형은 장치가 해당 콘텐츠에 대해 취해야 할 조치를 설명합니다.

상수값설명
QNdefNfcSmartPosterRecord::UnspecifiedAction-1조치가 정의되어 있지 않습니다.
QNdefNfcSmartPosterRecord::DoAction0조치를 수행합니다(SMS 전송, 브라우저 실행, 전화 걸기).
QNdefNfcSmartPosterRecord::SaveAction1나중에 저장(SMS를 수신함(INBOX)에 저장, URI를 북마크에 추가, 전화번호를 연락처에 저장).
QNdefNfcSmartPosterRecord::EditAction2편집하기 위해 열기(SMS를 SMS 편집기에서 열기, URI를 URI 편집기에서 열기, 전화번호를 편집하기 위해 열기).

멤버 함수 문서

QNdefNfcSmartPosterRecord::QNdefNfcSmartPosterRecord()

새로운 빈 스마트 포스터를 생성합니다.

QNdefNfcSmartPosterRecord::QNdefNfcSmartPosterRecord(const QNdefRecord &other)

other 의 복사본인 새로운 스마트 포스터를 생성합니다.

QNdefNfcSmartPosterRecord::QNdefNfcSmartPosterRecord(const QNdefNfcSmartPosterRecord &other)

other 의 복사본인 새로운 스마트 포스터를 생성합니다.

[noexcept] QNdefNfcSmartPosterRecord::~QNdefNfcSmartPosterRecord()

스마트 포스터를 파기합니다.

QNdefNfcSmartPosterRecord::Action QNdefNfcSmartPosterRecord::action() const

사용 가능한 경우 액션 레코드에서 액션을 반환합니다. 그렇지 않은 경우 ` UnspecifiedAction `가 반환됩니다.

setAction()도 참조하십시오 .

void QNdefNfcSmartPosterRecord::addIcon(const QNdefNfcIconRecord &icon)

스마트 포스터에 아이콘 레코드 icon 를 추가합니다. 스마트 포스터에 이미 동일한 유형의 아이콘 레코드가 있는 경우, 기존 아이콘 레코드가 대체됩니다.

void QNdefNfcSmartPosterRecord::addIcon(const QByteArray &type, const QByteArray &data)

스마트 포스터에 유형이 ‘ type ’이고 데이터가 ‘ data ’인 아이콘 레코드를 추가합니다. 스마트 포스터에 이미 동일한 유형의 아이콘 레코드가 있는 경우, 기존 아이콘 레코드가 대체됩니다.

bool QNdefNfcSmartPosterRecord::addTitle(const QNdefNfcTextRecord &text)

스마트 포스터에 제목 레코드 text 를 추가하려고 시도합니다. 스마트 포스터에 제목 레코드 text 와 로케일이 동일한 제목 레코드가 아직 없는 경우, 해당 제목 레코드가 추가되고 함수는 true 를 반환합니다. 그렇지 않은 경우 false 가 반환됩니다.

bool QNdefNfcSmartPosterRecord::addTitle(const QString &text, const QString &locale, QNdefNfcTextRecord::Encoding encoding)

제목 text, 로케일 locale, 인코딩 encoding 을 가진 새로운 제목 레코드를 추가하려고 시도합니다. 스마트 포스터에 로케일 locale 을 가진 제목 레코드가 아직 없는 경우, 해당 제목 레코드가 추가되고 함수는 true 를 반환합니다. 그렇지 않은 경우 false 를 반환합니다.

bool QNdefNfcSmartPosterRecord::hasAction() const

스마트 포스터에 액션 레코드가 포함되어 있으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

bool QNdefNfcSmartPosterRecord::hasIcon(const QByteArray &mimetype = QByteArray()) const

스마트 포스터에 ` mimetype` 유형을 사용하는 아이콘 레코드가 포함되어 있으면 ` true `를 반환합니다. ` mimetype `가 비어 있는 경우, 스마트 포스터에 아이콘 레코드가 하나 이상 포함되어 있으면 ` true `를 반환합니다. 그 외의 모든 경우에는 ` false `를 반환합니다.

bool QNdefNfcSmartPosterRecord::hasSize() const

스마트 포스터에 크기 레코드가 포함되어 있으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

bool QNdefNfcSmartPosterRecord::hasTitle(const QString &locale = QString()) const

스마트 포스터에 로케일 locale 을 사용하는 타이틀 레코드가 포함되어 있으면 true 을 반환합니다. locale 이 비어 있는 경우, 스마트 포스터에 타이틀 레코드가 하나 이상 포함되어 있으면 true 을 반환합니다. 그 외의 모든 경우에는 false 을 반환합니다.

bool QNdefNfcSmartPosterRecord::hasTypeInfo() const

스마트 포스터에 타입 레코드가 포함되어 있으면 ` true `을 반환하고, 그렇지 않으면 ` false`을 반환합니다.

QByteArray QNdefNfcSmartPosterRecord::icon(const QByteArray &mimetype = QByteArray()) const

스마트 포스터에 MIME 유형이 mimetype 인 아이콘 레코드가 포함되어 있는 경우, 해당 아이콘 레코드 데이터를 반환합니다. mimetype 가 생략되거나 비어 있는 경우, 첫 번째 아이콘의 레코드 데이터가 반환됩니다. 그 외의 모든 경우에는 빈 배열이 반환됩니다.

경고: 애플리케이션 개발자는 반환된 데이터를 처리하기 전에 유효성을 검증할 것을 권장합니다. 자세한 지침은 Qt NFC 의 ‘보안 고려 사항’을 참조하십시오.

qsizetype QNdefNfcSmartPosterRecord::iconCount() const

스마트 포스터에 포함된 아이콘 레코드 수를 반환합니다.

QNdefNfcIconRecord QNdefNfcSmartPosterRecord::iconRecord(qsizetype index) const

스마트 포스터 내의 인덱스 index 에 해당하는 아이콘 레코드를 반환합니다. 여기서 index 는 0과 iconCount() - 1 사이의 값입니다. 이 범위 밖의 값인 경우 빈 레코드가 반환됩니다.

QList<QNdefNfcIconRecord> QNdefNfcSmartPosterRecord::iconRecords() const

스마트 포스터 내에 있는 모든 아이콘 레코드의 복사본을 반환합니다.

bool QNdefNfcSmartPosterRecord::removeIcon(const QByteArray &type)

스마트 포스터에서 유형이 ` type `인 아이콘 레코드를 제거하려고 시도합니다. 스마트 포스터에 일치하는 레코드가 있으면 해당 레코드를 제거하고 ` true `를 반환하며, 그렇지 않은 경우 ` false `를 반환합니다.

bool QNdefNfcSmartPosterRecord::removeIcon(const QNdefNfcIconRecord &icon)

스마트 포스터에서 아이콘 레코드 icon 를 삭제하려고 시도합니다. 스마트 포스터에 일치하는 레코드가 있는 경우 해당 레코드를 삭제하고 true 를 반환하며, 그렇지 않은 경우 false 를 반환합니다.

bool QNdefNfcSmartPosterRecord::removeTitle(const QNdefNfcTextRecord &text)

스마트 포스터에서 제목 레코드 text 를 삭제하려고 시도합니다. 레코드를 삭제하고, 스마트 포스터에 일치하는 레코드가 있으면 true 를 반환하며, 그렇지 않은 경우 false 를 반환합니다.

bool QNdefNfcSmartPosterRecord::removeTitle(const QString &locale)

스마트 포스터에서 로케일 locale 을 가진 타이틀 레코드를 삭제하려고 시도합니다. 스마트 포스터에 일치하는 레코드가 있으면 해당 레코드를 삭제하고 true 를 반환하며, 그렇지 않은 경우 false 를 반환합니다.

void QNdefNfcSmartPosterRecord::setAction(QNdefNfcSmartPosterRecord::Action act)

액션 레코드를 다음과 같이 설정합니다. act

action()도 참조하십시오 .

void QNdefNfcSmartPosterRecord::setIcons(const QList<QNdefNfcIconRecord> &icons)

스마트 포스터에 아이콘 레코드 목록 icons 을 추가합니다. 기존 레코드가 있는 경우 덮어씁니다.

hasIcon() 및 icon()도 참조하십시오 .

void QNdefNfcSmartPosterRecord::setSize(quint32 size)

size 레코드를 설정합니다. 이 값에는 해당 URI가 가리키는 객체의 크기(바이트 단위)가 포함됩니다.

size() 및 hasSize()도 참조하십시오 .

void QNdefNfcSmartPosterRecord::setTitles(const QList<QNdefNfcTextRecord> &titles)

스마트 포스터에 제목 레코드 목록 titles 을 추가합니다. 기존 레코드가 있는 경우 덮어씁니다.

void QNdefNfcSmartPosterRecord::setTypeInfo(const QString &type)

타입 레코드를 ` type`로 설정합니다. ` type `는 ` uri()`가 참조하는 객체의 타입을 설명합니다.

typeInfo()도 참조하십시오 .

void QNdefNfcSmartPosterRecord::setUri(const QNdefNfcUriRecord &url)

URI 레코드를 다음과 같이 설정합니다. url

uri()도 참조하십시오 .

void QNdefNfcSmartPosterRecord::setUri(const QUrl &url)

URI 레코드를 생성하고, 스마트 포스터 내의 해당 레코드 내용을 다음과 같이 설정합니다. url

quint32 QNdefNfcSmartPosterRecord::size() const

사용 가능한 경우 크기 레코드에서 크기를 반환하고, 그렇지 않으면 0을 반환합니다.

이 값은 선택 사항이며, URI가 가리키는 객체의 크기를 바이트 단위로 포함합니다. 이 값은 장치가 해당 객체를 수용할 수 있는지 여부를 판단하는 데 사용될 수 있습니다.

setSize()도 참조하십시오 .

QString QNdefNfcSmartPosterRecord::title(const QString &locale = QString()) const

locale 로케일에 연결된 제목 레코드 텍스트가 있는 경우 이를 반환합니다. locale 가 비어 있으면, 사용 가능한 첫 번째 레코드의 제목 텍스트가 반환됩니다. 그 외의 모든 경우에는 빈 문자열이 반환됩니다.

qsizetype QNdefNfcSmartPosterRecord::titleCount() const

스마트 포스터에 포함된 타이틀 레코드 수를 반환합니다.

QNdefNfcTextRecord QNdefNfcSmartPosterRecord::titleRecord(qsizetype index) const

스마트 포스터 내의 인덱스 ` index `에 해당하는 제목 레코드를 반환합니다. 여기서 ` index `는 0부터 ` titleCount()` - 1 사이의 값입니다. 이 범위 외의 값을 입력하면 빈 레코드가 반환됩니다.

QList<QNdefNfcTextRecord> QNdefNfcSmartPosterRecord::titleRecords() const

스마트 포스터 내의 모든 타이틀 레코드 사본을 반환합니다.

QString QNdefNfcSmartPosterRecord::typeInfo() const

uri()를 통해 접근할 수 있는 객체의 유형을 설명하는 MIME 유형을 반환합니다.

유형이 알려지지 않은 경우, 반환되는 QString 는 비어 있습니다.

setTypeInfo() 및 hasTypeInfo()도 참조하십시오 .

QUrl QNdefNfcSmartPosterRecord::uri() const

설정된 경우 스마트 포스터의 URI 레코드에서 URI를 반환합니다. 그렇지 않은 경우 빈 URI가 반환됩니다.

경고: 애플리케이션 개발자는 반환된 URI를 처리하기 전에 유효성을 검증할 것을 권장합니다. 자세한 내용은 Qt NFC 의 '보안 고려 사항'을 참조하십시오.

setUri()도 참조하십시오 .

QNdefNfcUriRecord QNdefNfcSmartPosterRecord::uriRecord() const

설정되어 있는 경우 스마트 포스터의 URI 레코드를 반환합니다. 그렇지 않은 경우 빈 URI가 반환됩니다.

QNdefNfcSmartPosterRecord &QNdefNfcSmartPosterRecord::operator=(const QNdefNfcSmartPosterRecord &other)

other 스마트 포스터 레코드를 이 레코드에 할당하고, 이 레코드에 대한 참조를 반환합니다.

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