ComboBox.PlaceholderText プロパティ

  • リファレンス

定義

名前空間:
Microsoft.UI.Xaml.Controls
編集

ユーザー アクションまたはその他の操作によって値が変更されるまでコントロールに表示されるテキストを取得または設定します。

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

プロパティ値

String

Platform::String

winrt::hstring

値が選択されていない場合にコントロールに表示されるテキスト。 既定値は、空の文字列 ("") です。

例

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>

注釈

プレースホルダー テキストは、 SelectedIndex が -1 で SelectedItem が null の場合に表示 されます。 (これら 2 つのプロパティは同期状態に保たれます)。アイテムが選択されると、ユーザーはプレースホルダー テキストを表示できません。 ただし、 プログラムで SelectedIndex を -1 に設定するか 、SelectedItem を null に設定すると、プレースホルダー テキストが再び表示されます。

適用対象