SearchPane.TrySetQueryText(String) 方法

定義

命名空間:

Windows.ApplicationModel.Search

嘗試在搜尋窗格的搜尋方塊中設定文字。

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")]
public bool TrySetQueryText(string query);

function trySetQueryText(query)

Public Function TrySetQueryText (query As String) As Boolean

參數

query

String

Platform::String

winrt::hstring

要顯示在搜尋窗格搜尋方塊中的查詢文字。

傳回

Boolean

bool

true 如果已成功設定搜尋方塊文字，則為 ;否則為 false 。

屬性

DeprecatedAttribute

備註

重要

若要在應用程式中實作Windows 10或更新版本的搜尋，請使用AutoSuggestBox。 如需詳細資訊 ，請參閱自動建議方塊 。

您不應該在 app 中使用Windows.ApplicationModel.Search API (SearchPane、 SearchContract) 或SearchBox API，以供Windows 10或更新版本使用。

注意

應用程式無法使用搜尋方塊 (Windows.UI.Xaml.Controls.SearchBoxWinJS.UI.SearchBox/) 和 SearchPane。 在相同的應用程式中同時使用搜尋方塊和搜尋窗格，會導致應用程式擲回例外狀況，並出現下列訊息：「無法建立類型為 'Windows.UI.Xaml.Controls.SearchBox' 的實例」。

如果您有應用程式內搜尋方塊，請使用這個方法來維持搜尋窗格與搜尋方塊之間的一致性。 大部分的應用程式都應該在搜尋窗格上回複，而不是使用應用程式內搜尋 UI。