ComboBox.PlaceholderText Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Obtém ou define o texto exibido no controle até que o valor seja alterado por uma ação do usuário ou alguma outra operação.

public:
 property Platform::String ^ PlaceholderText { Platform::String ^ get(); void set(Platform::String ^ value); };

winrt::hstring PlaceholderText();

void PlaceholderText(winrt::hstring value);

public string PlaceholderText { get; set; }

var string = comboBox.placeholderText;
comboBox.placeholderText = string;

Public Property PlaceholderText As String

<ComboBox PlaceholderText="placeholderString"/>

Valor da propriedade

String

Platform::String

winrt::hstring

O texto exibido no controle quando nenhum valor é selecionado. O padrão é uma cadeia de caracteres vazia ("").

Exemplos

Veja como adicionar texto de espaço reservado a um ComboBox.

<ComboBox Header="Colors" PlaceholderText="Pick a color">
    <x:String>Blue</x:String>
    <x:String>Green</x:String>
    <x:String>Red</x:String>
    <x:String>Yellow</x:String>
</ComboBox>

Comentários

O texto do espaço reservado é mostrado quando SelectedIndex é -1 e SelectedItem é nulo. (Essas duas propriedades são mantidas em sincronia.) Um usuário não pode exibir o texto do espaço reservado depois que um item é selecionado. No entanto, você pode definir programaticamente SelectedIndex como -1 ou SelectedItem como nulo para fazer com que o texto do espaço reservado seja mostrado novamente.