CategoryModel QML Type

CategoryModel 유형은 Plugin.. . 더보기...

Import Statement:	`import QtLocation 6.8`
Since:	QtLocation 5.5

상속된 멤버를 포함한 모든 멤버 목록

속성

hierarchical : bool
plugin : Plugin
status : enumeration

신호

dataChanged()

방법

string errorString()

상세 설명

CategoryModel 유형은 현재 Plugin 에서 사용할 수 있는 카테고리의 모델을 제공합니다. 이 모델은 카테고리의 평면 목록과 카테고리 그룹을 나타내는 계층적 트리를 모두 지원합니다. 이는 hierarchical 속성으로 제어할 수 있습니다.

이 모델은 다음과 같은 역할을 지원합니다:

역할	유형	설명
카테고리	Category	현재 항목의 카테고리 객체입니다.
부모 카테고리	Category	현재 항목의 상위 카테고리 객체입니다. 부모가 없는 경우 null이 반환됩니다.

다음 예는 사용 가능한 모든 카테고리의 평면 목록을 표시합니다:

import QtQuick
import QtPositioning
import QtLocation

ListView {
    model: CategoryModel {
        plugin: myPlugin
        hierarchical: false
    }
    delegate: Text { text: category.name }
}

계층적 카테고리 모델에 액세스하려면 DelegateModel 을 사용하여 하위 항목에 액세스해야 합니다.

속성 문서

hierarchical : bool

이 속성은 모델이 카테고리의 계층적 트리를 제공할지 아니면 플랫 목록을 제공할지를 나타냅니다. 기본값은 true입니다.

plugin : Plugin

이 속성은 이 모델에서 사용하는 Plugin 공급자를 보유합니다.

status : enumeration [read-only]

이 속성은 모델의 상태를 보유합니다. 다음 중 하나가 될 수 있습니다:

CategoryModel.Null	카테고리 가져오기 쿼리가 실행되지 않았습니다. 모델이 비어 있습니다.
CategoryModel.Ready	마지막 작업 중에 오류가 발생하지 않았으며 모델에서 추가 작업을 수행할 수 있습니다.
CategoryModel.Loading	모델이 업데이트 중이며 완료될 때까지 다른 작업을 수행할 수 없습니다.
CategoryModel.Error	마지막 작업 중에 오류가 발생했지만 모델에 대한 추가 작업을 계속 수행할 수 있습니다.

신호 문서

dataChanged()

이 신호는 기본 데이터스토어에 중요한 변경이 이루어졌을 때 발생합니다.

애플리케이션은 자체 재량에 따라 이 신호에 따라 조치를 취해야 합니다. 모델에서 제공하는 데이터가 오래되었을 수 있으므로 언젠가는 모델을 다시 업데이트해야 하지만, 사용자가 아무런 조치 없이 카테고리가 변경되면 즉시 다시 업데이트하면 사용자가 당황할 수 있습니다.

해당 핸들러는 onDataChanged 입니다.

참고: 해당 핸들러는 onDataChanged 입니다.

메서드 문서

string errorString()

이 읽기 전용 속성은 최신 카테고리 모델 오류의 텍스트 표시를 보유합니다. 오류가 발생하지 않으면 빈 문자열이 반환됩니다.

연관된 텍스트 표현이 없는 오류가 발생한 경우에도 빈 문자열이 반환될 수 있습니다.

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