ComboBox.PlaceholderText Property

Definition

Namespace:

Windows.UI.Xaml.Controls

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:
 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"/>

Property Value

String

Platform::String

winrt::hstring

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.