AppNotificationComboBox.SelectedItem Eigenschaft

Definition

Namespace:

Microsoft.Windows.AppNotifications.Builder

Ruft das ausgewählte Element für ein App-Benachrichtigungs-Kombinationsfeld ab oder legt es fest.

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

winrt::hstring SelectedItem();

void SelectedItem(winrt::hstring value);

public string SelectedItem { get; set; }

var string = appNotificationComboBox.selectedItem;
appNotificationComboBox.selectedItem = string;

Public Property SelectedItem As String

Eigenschaftswert

String

Platform::String

winrt::hstring

Eine Zeichenfolge, die die ID des ausgewählten Elements enthält.

Beispiele

Im folgenden Beispiel wird die Verwendung dieser Eigenschaft veranschaulicht, um das ausgewählte Element für das Kombinationsfeld für die App-Benachrichtigung festzulegen.

var comboBox = new AppNotificationComboBox("combobox_id");
comboBox.Title = "Select an item:";
comboBox.Items = new Dictionary<string, string> { { "id_one", "Item one" }, { "id_two", "Item two" } };
comboBox.SelectedItem = "id_one";

var notification = new AppNotificationBuilder()
    .AddText("Notification text.")
    .AddComboBox(comboBox)
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Die resultierende XML-Nutzlast, wenn das dringende Szenario unterstützt wird:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Notification text.</text>
        </binding>
    </visual>
    <actions>
        <input id='combobox_id' type='selection' title='Select an item:' defaultInput='id_one'>
            <selection id='id_one' content='Item one'/>
            <selection id='id_two' content='Item two'/>
        </input>
    </actions>
</toast>

Hinweise

Sie können das ausgewählte Element auch festlegen, indem Sie AppNotificationComboBox.SetSelectedItemaufrufen.

Fügen Sie einem Kombinationsfeld Elemente hinzu, indem Sie AppNotificationComboBox.AddItem- oder mit der AppNotificationComboBox.Items-Eigenschaft aufrufen.

Anleitungen zur Verwendung der AppNotificationBuilder--APIs zum Erstellen der Benutzeroberfläche für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhalt.

Referenzinformationen zum XML-Schema für App-Benachrichtigungen finden Sie unter App-Benachrichtigungsinhaltsschema.