Freigeben über


SearchActivatedEventArgs Klasse

Definition

Stellt Informationen zu dem aktivierten Ereignis bereit, das ausgelöst wird, wenn der Benutzer die App über den Charm "Suchen" durchsucht und die App nicht die Haupt-App auf dem Bildschirm ist.

Javascript Dieser Typ wird als webUISearchActivatedEventArgs angezeigt.

public ref class SearchActivatedEventArgs sealed : IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
public ref class SearchActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SearchActivatedEventArgs final : IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SearchActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SearchActivatedEventArgs : IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SearchActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
Public NotInheritable Class SearchActivatedEventArgs
Implements IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
Public NotInheritable Class SearchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ISearchActivatedEventArgs, ISearchActivatedEventArgsWithLinguisticDetails, IViewSwitcherProvider
Vererbung
Object Platform::Object IInspectable SearchActivatedEventArgs
Attribute
Implementiert

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (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.

Wenn Ihre App in den Search-Vertrag integriert ist, wird ein SearchActivatedEventArgs-Objekt an den OnSearchActivated-Aktivierungspunkthandler Ihrer App übergeben, wenn der Benutzer die App über den Such-Charm durchsucht und Ihre App nicht die Haupt-App auf dem Bildschirm ist. Dieser Aktivierungstyp wird durch den ActivationKind.Search-Wert angegeben, der von der Kind-Eigenschaft zurückgegeben wird.

Alle Anwendungsüberschreibungen , die an einem Aktivierungsszenario beteiligt sind, sollten Window.Activate in ihren Implementierungen aufrufen.

Versionsverlauf

Windows-Version SDK-Version Wertschöpfung
1607 14393 Benutzer

Eigenschaften

CurrentlyShownApplicationViewId

Ruft den Bezeichner für die aktuell angezeigte App-Ansicht ab.

Kind

Ruft den Aktivierungstyp ab.

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 SearchPaneQueryLinguisticDetails-Objekt ab, das Informationen zu Abfragetext bereitstellt, den der Benutzer über einen Eingabemethoden-Editor (IME) eingibt.

PreviousExecutionState

Ruft den Ausführungsstatus der App ab, bevor sie aktiviert wurde.

QueryText

Ruft den Text ab, nach dem der Benutzer die App suchen soll. Der Benutzer hat diesen Text in das Suchfeld des Suchbereichs eingegeben.

SplashScreen

Ruft ein SplashScreen-Objekt ab, das Informationen zum Übergang vom Begrüßungsbildschirm zur aktivierten App bereitstellt.

User

Ruft den Benutzer ab, für den die App aktiviert wurde.

ViewSwitcher

Ruft das Ansichtswechselobjekt ab, mit dem Sie die Ansicht für die Anwendung festlegen können.

Gilt für:

Weitere Informationen