Back to Qt.io
Contact Us Blog Download Qt

Category QML Type

카테고리 유형은 Place 에 연결할 수 있는 카테고리를 나타냅니다. 더 보기...

Import Statement: import QtLocation 6.8
Since: QtLocation 5.5

속성

방법

상세 설명

카테고리는 장소가 연관된 카테고리를 기준으로 장소를 검색하는 데 사용됩니다. 사용 가능한 카테고리 목록은 CategoryModel 에서 확인할 수 있습니다. PlaceSearchModel 에는 지정된 카테고리가 있는 장소로 검색 결과를 제한하는 데 사용되는 categories 속성이 있습니다.

Plugin 에서 지원하는 경우 카테고리를 만들거나 제거할 수 있습니다. 새 카테고리를 만들려면 새 카테고리 객체를 만들고 해당 속성을 설정한 다음 save() 메서드를 호출합니다.

import QtPositioning
import QtLocation

Category {
    id: category

    plugin: myPlugin
    name: "New Category"
    visibility: Category.PrivateVisibility
}
...
category.save();

카테고리를 제거하려면 plugin 및 categoryId 속성이 설정되어 있는지 확인하고 remove() 메서드를 호출합니다.

CategoryModel 를참조하세요 .

속성 문서

categoryId : string

이 속성은 카테고리의 식별자를 보유합니다. categoryId는 카테고리 내에서 이 카테고리를 고유하게 식별하는 문자열입니다 plugin.


icon : PlaceIcon

이 속성은 카테고리와 관련된 이미지 소스를 보유합니다. 아이콘을 표시하려면 이미지 유형을 사용할 수 있습니다.


name : string

이 속성은 카테고리의 문자열 기반 이름을 보유합니다.


plugin : Plugin

이 속성은 카테고리가 속한 위치 기반 서비스를 보유합니다.


status : enumeration [read-only]

이 속성은 카테고리의 상태를 저장합니다. 다음 중 하나가 될 수 있습니다:

Category.Ready마지막 작업 중에 오류가 발생하지 않았으며, 카테고리에 대한 추가 작업을 수행할 수 있습니다.
Category.Saving카테고리가 현재 저장 중이며, 현재 작업이 완료될 때까지 다른 작업을 수행할 수 없습니다.
Category.Removing카테고리를 제거 중이며, 현재 작업이 완료될 때까지 다른 작업을 수행할 수 없습니다.
Category.Error마지막 작업 중에 오류가 발생했지만 카테고리에 대한 추가 작업을 계속 수행할 수 있습니다.

visibility : enumeration

이 속성은 카테고리의 가시성을 유지합니다. 다음 중 하나가 될 수 있습니다:

카테고리.지정되지 않은 가시성카테고리의 표시 여부가 지정되지 않았습니다. 카테고리를 저장하면 플러그인은 백엔드에 저장된 카테고리에 대한 기본 가시성을 자동으로 설정합니다. 이 기본값은 플러그인 구현에 따라 달라집니다.
카테고리.디바이스 가시성카테고리는 현재 디바이스로 제한됩니다. 카테고리는 디바이스 외부로 전송되지 않습니다.
카테고리.비공개 가시성카테고리는 현재 사용자에게 비공개입니다. 카테고리는 온라인 서비스로 전송될 수 있지만 현재 사용자에게만 표시됩니다.
카테고리.공개 가시성카테고리가 공개입니다.

공개 여부는 디바이스의 애플리케이션 사용자 인터페이스에서 카테고리와 연결된 Place가 표시되는 방식에는 영향을 주지 않습니다. 대신 카테고리의 공유 의미를 정의합니다.


메서드 문서

string errorString()

마지막 작업의 오류에 대한 문자열 설명을 반환합니다. 마지막 작업이 성공적으로 완료되면 문자열은 비어 있습니다.


void remove()

이 메서드는 백엔드 서비스에서 카테고리를 영구적으로 제거합니다.


void save()

이 메서드는 카테고리를 백엔드 서비스에 저장합니다.


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