Partilhar via


SearchPaneSuggestionsRequestedEventArgs Classe

Definição

Fornece dados para um evento SuggestionsRequested associado a um objeto SearchPane .

public ref class SearchPaneSuggestionsRequestedEventArgs sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Search.SearchContract, 65536)]
/// [Windows.Foundation.Metadata.Deprecated("SearchPaneSuggestionsRequestedEventArgs may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.ApplicationModel.Search.SearchContract)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SearchPaneSuggestionsRequestedEventArgs final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Search.SearchContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Deprecated("SearchPaneSuggestionsRequestedEventArgs may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
class SearchPaneSuggestionsRequestedEventArgs final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Search.SearchContract), 65536)]
[Windows.Foundation.Metadata.Deprecated("SearchPaneSuggestionsRequestedEventArgs may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.ApplicationModel.Search.SearchContract))]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SearchPaneSuggestionsRequestedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Search.SearchContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Deprecated("SearchPaneSuggestionsRequestedEventArgs may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
public sealed class SearchPaneSuggestionsRequestedEventArgs
Public NotInheritable Class SearchPaneSuggestionsRequestedEventArgs
Herança
Object Platform::Object IInspectable SearchPaneSuggestionsRequestedEventArgs
Atributos
Implementações

Requisitos do Windows

Família de dispositivos
Windows Desktop Extension SDK (introduzida na 10.0.10240.0)
Xbox One Extensions for the UWP (introduzida na 10.0.10586.0)
API contract
Windows.ApplicationModel.Search.SearchContract (introduzida na v1.0)

Comentários

Importante

Para implementar a pesquisa em um aplicativo para Windows 10 ou posterior, use AutoSuggestBox. Confira Caixa de sugestão automática para obter mais informações.

Você não deve usar APIs Windows.ApplicationModel.Search (SearchPane, SearchContract) ou APIs SearchBox em aplicativos para Windows 10 ou posterior.

Esse objeto é passado para o manipulador de eventos SuggestionsRequested de um aplicativo.

Usar seu aplicativo para fornecer sugestões

Há algumas maneiras diferentes de obter sugestões para que seu aplicativo forneça:

  • De uma lista local, estática e definida pelo aplicativo
  • De uma URL que dá suporte a sugestões no formato OpenSearch
  • De uma URL que dá suporte a sugestões no formato XML Depois de obter sugestões, você deve acrescentá-las à coleção de sugestões a serem exibidas para a consulta do usuário. Acesse essa coleção com a propriedade searchPaneSuggestionsRequest.searchSuggestionCollection .

Observação

Se você quiser fornecer sugestões de resultados, também deverá escutar e manipular o evento ResultSuggestionChosen .

Propriedades

Language

Obtém a marca de idioma IETF (Internet Engineering Task Force) (padrão BCP 47) que identifica o idioma atualmente associado ao dispositivo de entrada de texto do usuário.

LinguisticDetails

Obtém um objeto que fornece informações linguísticas sobre o texto da consulta que o usuário está inserindo por meio de um IME (Editor de Método de Entrada).

QueryText

Obtém o texto para o qual o aplicativo deve fornecer sugestões e que estava na caixa de pesquisa quando ocorreu o evento SuggestionsRequested .

Request

Obtém um objeto que armazena sugestões e informações sobre a solicitação.

Aplica-se a