SearchPane.PlaceholderText Propiedad

Definición

Espacio de nombres:

Windows.ApplicationModel.Search

Texto del marcador de posición en el cuadro de búsqueda cuando el usuario no ha escrito ningún carácter.

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);

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

Valor de propiedad

String

Platform::String

winrt::hstring

Texto del marcador de posición que se va a mostrar en el cuadro de búsqueda.

Atributos

DeprecatedAttribute

Comentarios

Importante

Para implementar la búsqueda en una aplicación para Windows 10 o posterior, use AutoSuggestBox. Consulta Cuadro de sugerencias automáticas para obtener más información.

No debe usar las API Windows.ApplicationModel.Search (SearchPane, SearchContract) ni las API searchBox en aplicaciones para Windows 10 o posterior.

Nota:

Una aplicación no puede usar el cuadro de búsqueda (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) y searchPane. El uso del cuadro de búsqueda y el panel de búsqueda de la misma aplicación hace que la aplicación produzca una excepción con este mensaje: "No se puede crear una instancia de tipo 'Windows.UI.Xaml.Controls.SearchBox'".

Puede usar el texto del marcador de posición para dar al usuario una indicación sobre lo que puede buscar.

Si el texto del marcador de posición es demasiado largo para caber en el cuadro de búsqueda, el sistema trunca el texto sin generar una excepción.

Consulte también

• SearchPane