Category QML Type
‘카테고리’ 유형은 ‘ Place ’가 연결될 수 있는 카테고리를 나타냅니다. 더 보기...
| Import Statement: | import QtLocation 6.12 |
| Since: | QtLocation 5.5 |
속성
- categoryId : string
- icon : PlaceIcon
- name : string
- plugin : Plugin
- status : enumeration
- visibility : enumeration
방법
- string errorString()
- void remove()
- void save()
상세 설명
카테고리는 장소가 속한 카테고리를 기준으로 장소를 검색하는 데 사용됩니다. 사용 가능한 카테고리 목록은 CategoryModel 에서 확인할 수 있습니다. PlaceSearchModel 에는 categories 속성이 있으며, 이 속성을 사용하여 검색 결과를 지정된 카테고리를 가진 장소로 제한할 수 있습니다.
Plugin 가 이를 지원하는 경우, 카테고리를 생성하거나 제거할 수 있습니다. 새 카테고리를 생성하려면 새로운 Category 객체를 생성하고 해당 속성을 설정한 다음, 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
이 속성은 카테고리와 연결된 이미지 소스를 저장합니다. 아이콘을 표시하려면 Image 유형을 사용할 수 있습니다.
name : string
이 속성은 카테고리의 문자열 형식의 이름을 저장합니다.
plugin : Plugin
이 속성은 해당 카테고리가 속한 위치 기반 서비스를 저장합니다.
status : enumeration [read-only]
이 속성은 카테고리의 상태를 나타냅니다. 다음 중 하나일 수 있습니다:
| Category.Ready | 마지막 작업 중에 오류가 발생하지 않았으며, 해당 카테고리에 대해 추가 작업을 수행할 수 있습니다. |
| Category.Saving | 현재 카테고리가 저장 중이며, 현재 작업이 완료될 때까지 다른 작업을 수행할 수 없습니다. |
| Category.Removing | 현재 카테고리를 제거 중입니다. 현재 작업이 완료될 때까지 다른 작업을 수행할 수 없습니다. |
| Category.Error | 마지막 작업 중에 오류가 발생했습니다. 해당 카테고리에 대해서는 여전히 다른 작업을 수행할 수 있습니다. |
visibility : enumeration
이 속성은 카테고리의 표시 여부를 나타냅니다. 다음 중 하나일 수 있습니다:
| Category.UnspecifiedVisibility | 카테고리의 공개 범위가 지정되지 않았습니다. 카테고리를 저장할 때, 플러그인은 백엔드에 저장된 카테고리에 대해 기본 공개 범위를 자동으로 설정합니다. 이 기본값은 플러그인 구현 방식에 따라 달라집니다. |
| Category.DeviceVisibility | 카테고리가 현재 기기로 제한됩니다. 해당 카테고리는 기기 외부로 전송되지 않습니다. |
| Category.PrivateVisibility | 이 카테고리는 현재 사용자에게만 비공개로 제공됩니다. 이 카테고리는 온라인 서비스로 전송될 수 있지만, 오직 현재 사용자만 볼 수 있습니다. |
| Category.PublicVisibility | 이 카테고리는 공개됩니다. |
가시성 설정은 해당 카테고리와 연결된 ` Place`가 기기 내 애플리케이션의 사용자 인터페이스에 표시되는 방식에는 영향을 미치지 않습니다. 대신, 이 설정은 카테고리의 공유 방식을 정의합니다.
메서드 문서
string errorString()
마지막 작업의 오류에 대한 설명을 문자열로 반환합니다. 마지막 작업이 성공적으로 완료된 경우, 이 문자열은 비어 있습니다.
void remove()
이 방법은 백엔드 서비스에서 해당 카테고리를 영구적으로 삭제합니다.
void save()
이 메서드는 카테고리를 백엔드 서비스에 저장합니다.
© 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.