SearchBox.SetLocalContentSuggestionSettings Método

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Especifica si las sugerencias basadas en archivos locales se muestran automáticamente en las sugerencias del cuadro de búsqueda y define los criterios que Windows usa para buscar y filtrar estas sugerencias.

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)

Parámetros

settings

LocalContentSuggestionSettings

La nueva configuración de las sugerencias de contenido local.

Ejemplos

Aquí, las sugerencias están restringidas a un tipo de archivo, archivos de música, mediante una cadena de AQS. Dos de los filtros AQS más comunes restringen en función del tipo de archivo, como "kind:music" en el ejemplo; y en función de la extensión de nombre de archivo, como "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);
}

Comentarios

Cuando se habilitan las sugerencias de contenido local, Windows proporciona sugerencias de búsqueda de los archivos locales del usuario a medida que el usuario escribe texto de consulta. Por ejemplo, una aplicación de imagen puede configurar sugerencias de contenido local para que las sugerencias de búsqueda provengan solo de un tipo determinado de archivo de imagen almacenado en la biblioteca de imágenes del usuario.

Para buscar en una biblioteca local, la funcionalidad adecuada debe declararse en el manifiesto de la aplicación. Para obtener más información, consulta Declaraciones de funcionalidades de las aplicaciones.