Freigeben über


SearchPaneSuggestionsRequestedEventArgs Klasse

Definition

Stellt Daten für ein SuggestionsRequested-Ereignis bereit, das einem SearchPane-Objekt zugeordnet ist.

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
Vererbung
Object Platform::Object IInspectable SearchPaneSuggestionsRequestedEventArgs
Attribute
Implementiert

Windows-Anforderungen

Gerätefamilie
Windows Desktop Extension SDK (eingeführt in 10.0.10240.0)
Xbox One Extensions for the UWP (eingeführt in 10.0.10586.0)
API contract
Windows.ApplicationModel.Search.SearchContract (eingeführt in v1.0)

Hinweise

Wichtig

Verwenden Sie AutoSuggestBox, um die Suche in einer App für Windows 10 oder höher zu implementieren. Weitere Informationen finden Sie unter Automatische Vorschläge .

Sie sollten keine Windows.ApplicationModel.Search-APIs (SearchPane, SearchContract) oder SearchBox-APIs in Apps für Windows 10 oder höher verwenden.

Dieses Objekt wird an den SuggestionsRequested-Ereignishandler einer App übergeben.

Verwenden Ihrer App zum Bereitstellen von Vorschlägen

Es gibt verschiedene Möglichkeiten, Vorschläge für Ihre App zu erhalten:

  • Aus einer app-definierten, statischen, lokalen Liste
  • Über eine URL, die Vorschläge im OpenSearch-Format unterstützt
  • Über eine URL, die Vorschläge im XML-Format unterstützt, nachdem Sie Vorschläge erhalten haben, müssen Sie sie an die Sammlung von Vorschlägen anfügen, die für die Abfrage des Benutzers angezeigt werden sollen. Greifen Sie mit der searchPaneSuggestionsRequest.searchSuggestionCollection-Eigenschaft auf diese Sammlung zu.

Hinweis

Wenn Sie Ergebnisvorschläge bereitstellen möchten, müssen Sie auch das ResultSuggestionChosen-Ereignis überwachen und behandeln.

Eigenschaften

Language

Ruft das IETF-Sprachtag (Internet Engineering Task Force) (BCP 47 Standard) ab, das die Sprache identifiziert, die derzeit dem Texteingabegerät des Benutzers zugeordnet ist.

LinguisticDetails

Ruft ein -Objekt ab, das linguistische Informationen zu Abfragetext bereitstellt, den der Benutzer über einen Eingabemethoden-Editor (IME) eingibt.

QueryText

Ruft den Text ab, für den die App Vorschläge bereitstellen soll und der sich im Suchfeld befand, als das SuggestionsRequested-Ereignis aufgetreten ist.

Request

Ruft ein -Objekt ab, das Vorschläge und Informationen zur Anforderung speichert.

Gilt für: