ComboBox.PlaceholderText property

Applies to Windows and Windows Phone

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

Syntax


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


<ComboBox PlaceholderText="placeholderString"/>


XAML Values

placeholderString

A text string that serves as placeholder content.

Property value

Type: System.String [.NET] | Platform::String [C++]

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

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.

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>


Requirements

Minimum supported client

Windows 8.1

Minimum supported server

Windows Server 2012 R2

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]

Namespace

Windows.UI.Xaml.Controls
Windows::UI::Xaml::Controls [C++]

Metadata

Windows.winmd

See also

ComboBox

 

 

Show:
© 2014 Microsoft