다음을 통해 공유


LocalContentSuggestionSettings 클래스

정의

앱이 로컬 파일을 기반으로 제안을 제공하는지 여부와 이러한 제안을 찾아 필터링하는 데 사용되는 조건을 정의하는 설정을 저장합니다.

public ref class LocalContentSuggestionSettings sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class LocalContentSuggestionSettings final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class LocalContentSuggestionSettings final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class LocalContentSuggestionSettings
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LocalContentSuggestionSettings
function LocalContentSuggestionSettings()
Public NotInheritable Class LocalContentSuggestionSettings
상속
Object Platform::Object IInspectable LocalContentSuggestionSettings
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

중요

앱에서 Windows 10 이상 검색을 구현하려면 AutoSuggestBox를 사용합니다. 자세한 내용은 자동 제안 상자를 참조하세요.

Windows 10 이상 앱에서 Windows.ApplicationModel.Search API(SearchPane, SearchContract) 또는 SearchBox API를 사용하면 안 됩니다.

앱에서 제공하는 제안은 사용자의 로컬 인덱싱된 파일의 메타데이터 필드 및 속성을 기반으로 합니다.

사용하도록 설정하면 사용자가 검색 상자에 쿼리를 입력하면 검색 창에 로컬 제안이 표시됩니다.

Enabled 속성을 false로 설정하여 이러한 제안을 사용하지 않도록 설정합니다.

참고

이 클래스는 민첩하지 않으므로 스레딩 모델 및 마샬링 동작을 고려해야 합니다. 자세한 내용은 스레딩 및 마샬링(C++/CX)다중 스레드 환경에서 Windows 런타임 개체 사용(.NET)을 참조하세요.

생성자

LocalContentSuggestionSettings()

LocalContentSuggestionSettings 클래스의 새 인스턴스를 만듭니다.

속성

AqsFilter

제안을 제공하는 데 사용되는 파일의 형식과 종류를 제한하는 AQS(고급 쿼리 구문) 문자열입니다. AQS(고급 쿼리 구문) 문자열이 지정되지 않은 경우 Locations 속성으로 지정된 위치에 있는 모든 로컬 파일에서 제안이 제공됩니다.

Enabled

로컬 파일을 기반으로 하는 제안이 검색 창에 표시되는지 여부를 나타냅니다.

Locations

제안을 제공하는 데 사용되는 파일이 포함된 StorageFolder 개체의 목록입니다. 목록이 비어 있으면 앱이 기능을 선언한 모든 로컬 라이브러리의 파일에서 제안이 제공됩니다.

PropertiesToMatch

값이 로컬 파일의 제안을 제공하는 데 사용되는 파일 속성 목록입니다. 목록이 비어 있으면 제안에 사용할 수 있는 모든 파일 속성이 사용됩니다.

적용 대상

추가 정보