SearchBox.SetLocalContentSuggestionSettings 메서드

정의

네임스페이스:

Windows.UI.Xaml.Controls

로컬 파일을 기반으로 하는 제안이 검색 상자 제안에 자동으로 표시되는지 여부를 지정하고 Windows에서 이러한 제안을 찾아 필터링하는 데 사용하는 조건을 정의합니다.

public:
 virtual void SetLocalContentSuggestionSettings(LocalContentSuggestionSettings ^ settings) = SetLocalContentSuggestionSettings;

void SetLocalContentSuggestionSettings(LocalContentSuggestionSettings const& settings);

public void SetLocalContentSuggestionSettings(LocalContentSuggestionSettings settings);

function setLocalContentSuggestionSettings(settings)

Public Sub SetLocalContentSuggestionSettings (settings As LocalContentSuggestionSettings)

매개 변수

settings

LocalContentSuggestionSettings

로컬 콘텐츠 제안에 대한 새 설정입니다.

예제

여기서 제안은 AQS 문자열을 사용하여 한 종류의 파일, 음악 파일로 제한됩니다. 가장 일반적인 두 AQS 필터는 예제의 "kind:music"처럼 파일 종류에 따라 제한됩니다. 및 는 파일 이름 확장명(예: "ext:.mp3")을 기반으로 합니다.

public MainPage()
{
    this.InitializeComponent();

    // Let Windows provide suggestions from local files.
    var settings = new Windows.ApplicationModel.Search.LocalContentSuggestionSettings();
    settings.Enabled = true;
    // Access to the music library requires that the Music Library capability
    // be declared in the app manifest .
    settings.Locations.Add(Windows.Storage.KnownFolders.MusicLibrary);
    settings.AqsFilter = "kind:Music";
    MySearchBox.SetLocalContentSuggestionSettings(settings);
}

설명

로컬 콘텐츠 제안을 사용하도록 설정하면 Windows는 사용자가 쿼리 텍스트를 입력할 때 사용자의 로컬 파일에서 검색 제안을 제공합니다. 예를 들어 사진 애플리케이션은 사용자의 사진 라이브러리에 저장된 특정 종류의 이미지 파일에서만 검색 제안이 오도록 로컬 콘텐츠 제안을 구성할 수 있습니다.

로컬 라이브러리를 검색하려면 앱 매니페스트에서 적절한 기능을 선언해야 합니다. 자세한 내용은 앱 접근 권한 값 선언을 참조하세요.