ComboBox.PlaceholderText ComboBox.PlaceholderText ComboBox.PlaceholderText ComboBox.PlaceholderText Property

Definition

Gets or sets the text that is displayed in the control until the value is changed by a user action or some other operation.

public : Platform::String PlaceholderText { get; set; }
winrt::hstring PlaceholderText();

void PlaceholderText(winrt::hstring placeholdertext);
public string PlaceholderText { get; set; }
Public ReadWrite Property PlaceholderText As string
<ComboBox PlaceholderText="placeholderString"/>

Property Value

string string

The text that is displayed in the control when no value is selected. The default is an empty string ("").

Examples

Here's how to add placeholder text to a 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>

Remarks

The placeholder text is shown when the SelectedIndex is -1 and the SelectedItem is null. (These two properties are kept in sync.) A user can't display the placeholder text once an item has been selected. However, you can programmatically set either the SelectedIndex to -1 or the SelectedItem to null to cause the placeholder text to be shown again.