SearchPane.TrySetQueryText(String) Methode

Referenz

Definition

Namespace:: Windows.ApplicationModel.Search

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Versucht, den Text im Suchfeld des Suchbereichs festzulegen.

public:
 virtual bool TrySetQueryText(Platform::String ^ query) = TrySetQueryText;

/// [Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.ApplicationModel.Search.SearchContract)]
bool TrySetQueryText(winrt::hstring const& query);

/// [Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
bool TrySetQueryText(winrt::hstring const& query);

[Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.ApplicationModel.Search.SearchContract))]
public bool TrySetQueryText(string query);

[Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
public bool TrySetQueryText(string query);

function trySetQueryText(query)

Public Function TrySetQueryText (query As String) As Boolean

Parameter

query: String
Platform::String

winrt::hstring

Der Abfragetext, der im Suchfeld des Suchbereichs angezeigt werden soll.

Gibt zurück

Boolean

bool

true , wenn der Suchfeldtext erfolgreich festgelegt wurde; falseandernfalls .

Attribute: DeprecatedAttribute

Hinweise

Wichtig

Verwenden Sie AutoSuggestBox, um die Suche in einer App für Windows 10 oder höher zu implementieren. Weitere Informationen finden Sie im Feld für 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.

Hinweis

Eine App kann nicht sowohl das Suchfeld (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) als auch die SearchPane verwenden. Wenn Sie sowohl das Suchfeld als auch den Suchbereich in derselben App verwenden, löst die App eine Ausnahme mit der folgenden Meldung aus: "Instanz vom Typ 'Windows.UI.Xaml.Controls.SearchBox' kann nicht erstellt werden."

Wenn Sie über ein In-App-Suchfeld verfügen, verwenden Sie diese Methode, um die Konsistenz zwischen dem Suchbereich und Ihrem Suchfeld zu gewährleisten. Die meisten Apps sollten im Suchbereich antworten, anstatt die Benutzeroberfläche für die In-App-Suche zu verwenden.

Gilt für:

Freigeben über