Back to Qt.io
Contact Us Blog Download Qt

QVirtualKeyboardDictionaryManager Class

애플리케이션 정의 사전을 위한 사전 관리. 더 보기...

Header: #include <QVirtualKeyboardDictionaryManager>
CMake: find_package(Qt6 REQUIRED COMPONENTS VirtualKeyboard)
target_link_libraries(mytarget PRIVATE Qt6::VirtualKeyboard)
qmake: QT += virtualkeyboard
상속합니다: QObject

속성

공공 기능

QStringList activeDictionaries() const
QStringList availableDictionaries() const
QStringList baseDictionaries() const
QVirtualKeyboardDictionary *createDictionary(const QString &name)
QVirtualKeyboardDictionary *dictionary(const QString &name) const
QStringList extraDictionaries() const
void setBaseDictionaries(const QStringList &baseDictionaries)
void setExtraDictionaries(const QStringList &extraDictionaries)

신호

void activeDictionariesChanged()
void availableDictionariesChanged()
void baseDictionariesChanged()
void extraDictionariesChanged()

정적 공용 멤버

QVirtualKeyboardDictionaryManager *instance()

상세 설명

이 클래스를 사용하면 가상 키보드 입력 메서드에 대한 사전을 관리할 수 있습니다. 사전은 애플리케이션에 정의되며 원하는 컨텍스트에서 활성화할 수 있습니다.

참고: 사전은 입력 메소드의 내장 사전이 아니라 애플리케이션의 자체 사전(예: 전화번호부 애플리케이션)을 참조합니다.

사전 관리자는 다음 작업을 지원합니다:

  • createDictionary() 함수를 사용하여 사전 만들기.
  • 사전 인스턴스의 콘텐츠를 추가하거나 수정합니다.
  • base dictionaries 또는 extra dictionaries 의 목록에 사전을 추가하여 사전을 활성화합니다.

QML에서 사전을 활성화하려면 VirtualKeyboard 첨부 유형을 사용하세요.

속성 문서

[read-only] activeDictionaries : const QStringList

이 속성은 현재 활성화된 사전 목록을 보유합니다.

이 속성에는 baseDictionaries 및 extraDictionaries 에 포함된 고유 이름의 조합인 활성 사전 목록이 저장됩니다.

액세스 함수:

QStringList activeDictionaries() const

알림 신호:

void activeDictionariesChanged()

[read-only] availableDictionaries : const QStringList

이 속성에는 모든 사전의 목록이 저장됩니다.

이 속성에는 모든 기존 사전의 이름이 저장됩니다.

함수에 액세스합니다:

QStringList availableDictionaries() const

알림 신호:

void availableDictionariesChanged()

baseDictionaries : QStringList

이 속성에는 현재 활성화된 기본 사전의 목록이 저장됩니다.

이 속성에는 기본 사전의 이름이 저장됩니다. 애플리케이션이 이 속성을 관리합니다.

함수 액세스:

QStringList baseDictionaries() const
void setBaseDictionaries(const QStringList &baseDictionaries)

알림 신호:

void baseDictionariesChanged()

extraDictionaries : QStringList

이 속성에는 현재 활성화된 추가 사전의 목록이 저장됩니다.

이 속성에는 추가 사전의 이름이 저장됩니다. 애플리케이션이 이 속성을 관리합니다.

함수 액세스:

QStringList extraDictionaries() const
void setExtraDictionaries(const QStringList &extraDictionaries)

알림 신호:

void extraDictionariesChanged()

멤버 함수 문서

QVirtualKeyboardDictionary *QVirtualKeyboardDictionaryManager::createDictionary(const QString &name)

주어진 name 으로 사전을 만들거나 사전이 이미 있는 경우 사전을 반환합니다.

사전 인스턴스는 사전 관리자가 소유하며 수동으로 삭제해서는 안 됩니다. 사전용으로 할당된 메모리를 확보하기 위해 애플리케이션은 사전의 contents 을 재설정할 수 있습니다.

dictionary()도 참조하세요 .

QVirtualKeyboardDictionary *QVirtualKeyboardDictionaryManager::dictionary(const QString &name) const

주어진 name 이 있는 경우 기존 사전을 반환하고, 그렇지 않으면 nullptr 을 반환합니다.

createDictionary()도 참조하세요 .

[static] QVirtualKeyboardDictionaryManager *QVirtualKeyboardDictionaryManager::instance()

QVirtualKeyboardDictionaryManager 의 싱글톤 인스턴스를 반환합니다.

모든 함수는 메인 스레드에서 호출해야 합니다.

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