Back to Qt.io
Contact Us Blog Download Qt
이 페이지에서

QVirtualKeyboardDictionaryManager Class

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

헤더: #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 ` 부착형(attached type)을 사용하십시오.

속성 설명서

[read-only] activeDictionaries : QStringList

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

이 속성은 활성 사전 목록을 포함하며, 이 목록은 baseDictionaries 및 extraDictionaries 에 포함된 고유 이름들의 조합입니다.

액세스 함수:

QStringList activeDictionaries() const

알림 신호:

void activeDictionariesChanged()

[read-only] availableDictionaries : 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 가 존재하면 해당 사전(dictionary)을 반환하고, 그렇지 않으면 nullptr 를 반환합니다.

createDictionary()도 참조하십시오 .

[static] QVirtualKeyboardDictionaryManager *QVirtualKeyboardDictionaryManager::instance()

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

모든 기능은 메인 스레드에서 호출되어야 합니다.

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