Share via


SearchPaneSuggestionsRequestedEventArgs Classe

Définition

Fournit des données pour un événement SuggestionsRequested associé à un objet 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
Héritage
Object Platform::Object IInspectable SearchPaneSuggestionsRequestedEventArgs
Attributs
Implémente

Configuration requise pour Windows

Famille d’appareils
Windows Desktop Extension SDK (introduit dans 10.0.10240.0)
Xbox One Extensions for the UWP (introduit dans 10.0.10586.0)
API contract
Windows.ApplicationModel.Search.SearchContract (introduit dans v1.0)

Remarques

Important

Pour implémenter la recherche dans une application pour Windows 10 ou une version ultérieure, utilisez AutoSuggestBox. Pour plus d’informations, consultez la zone Suggestion automatique.

Vous ne devez pas utiliser les API Windows.ApplicationModel.Search (SearchPane, SearchContract) ou les API SearchBox dans les applications pour Windows 10 ou une version ultérieure.

Cet objet est passé au gestionnaire d’événements SuggestionsRequested d’une application.

Utiliser votre application pour fournir des suggestions

Il existe plusieurs façons d’obtenir des suggestions pour votre application :

  • À partir d’une liste locale statique définie par l’application
  • À partir d’une URL qui prend en charge les suggestions au format OpenSearch
  • À partir d’une URL qui prend en charge les suggestions au format XML Après avoir obtenu des suggestions, vous devez les ajouter à la collection de suggestions à afficher pour la requête de l’utilisateur. Accédez à cette collection avec la propriété searchPaneSuggestionsRequest.searchSuggestionCollection .

Notes

Si vous souhaitez fournir des suggestions de résultats, vous devez également écouter et gérer l’événement ResultSuggestionChosen .

Propriétés

Language

Obtient la balise de langue IETF (Internet Engineering Task Force) (norme BCP 47) qui identifie la langue actuellement associée au périphérique d’entrée de texte de l’utilisateur.

LinguisticDetails

Obtient un objet qui fournit des informations linguistiques sur le texte de requête que l’utilisateur entre par le biais d’un éditeur de méthode d’entrée (IME).

QueryText

Obtient le texte pour lequel l’application doit fournir des suggestions et qui se trouvait dans la zone de recherche lorsque l’événement SuggestionsRequested s’est produit.

Request

Obtient un objet qui stocke des suggestions et des informations sur la demande.

S’applique à