共用方式為

SearchPane.PlaceholderText 屬性

  • 參考

定義

命名空間:
Windows.ApplicationModel.Search
編輯

當使用者未輸入任何字元時，搜尋方塊中的預留位置文字。

public:
 property Platform::String ^ PlaceholderText { Platform::String ^ get(); void set(Platform::String ^ value); };
/// [get: 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)]
/// [set: 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)]
winrt::hstring PlaceholderText();

void PlaceholderText(winrt::hstring value);
/// [get: 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")]
/// [set: 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")]
winrt::hstring PlaceholderText();

void PlaceholderText(winrt::hstring value);
public string PlaceholderText { [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))] get; [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))] set; }
public string PlaceholderText { [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")] get; [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")] set; }
var string = searchPane.placeholderText;
searchPane.placeholderText = string;
Public Property PlaceholderText As String

屬性值

String

Platform::String

winrt::hstring

要顯示在搜尋方塊中的預留位置文字。

屬性
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'的實例。」

您可以使用預留位置文字，讓使用者知道可以搜尋的內容。

如果預留位置文字太長而無法放入搜尋方塊中，系統就會截斷文字，而不會引發例外狀況。

適用於

另請參閱