AppNotificationProgressBar.SetValueStringOverride(String) Methode

Definition

Namespace:
Microsoft.Windows.AppNotifications.Builder
Bearbeiten

Legt die Außerkraftsetzung der Wertzeichenfolge einer Statusleiste für App-Benachrichtigungen fest.

public:
 virtual AppNotificationProgressBar ^ SetValueStringOverride(Platform::String ^ value) = SetValueStringOverride;
AppNotificationProgressBar SetValueStringOverride(winrt::hstring const& value);
public AppNotificationProgressBar SetValueStringOverride(string value);
function setValueStringOverride(value)
Public Function SetValueStringOverride (value As String) As AppNotificationProgressBar

Parameter

value
String

Platform::String

winrt::hstring

Eine Zeichenfolge, die den Wertzeichenfolgenüberschreibungstext enthält.

Gibt zurück

AppNotificationProgressBar

Gibt die AppNotificationProgressBar-Instanz zurück, sodass zusätzliche Methodenaufrufe verkettet werden können.

Beispiele

Das folgende Beispiel veranschaulicht, wie die ValueStringOverride-Eigenschaft einer App-Benachrichtigungsstatusleiste festgelegt wird.

 var notification = new AppNotificationBuilder()
    .AddText("Downloading your weekly playlist...")
    .AddProgressBar(new AppNotificationProgressBar()
        .SetTitle("Progress bar title")
        .SetValue(.5)
        .SetStatus("Downloading...")
        .SetValueStringOverride("1/2 files downloaded"))
    .BuildNotification();

AppNotificationManager.Default.Show(notification);

Die resultierende XML-Nutzlast:

<toast>
    <visual>
        <binding template='ToastGeneric'>
            <text>Downloading your weekly playlist...</text>
            <progress title='Progress bar title' status='Downloading...' value='0.5' valueStringOverride='1/2 files downloaded'/>
        </binding>
    </visual>
</toast>

Hinweise

Sie können auch den Wertzeichenfolgenüberschreibungstext mit der Eigenschaft AppNotificationProgressBar.ValueStringOverride festlegen.

Sie können den Titeltext mithilfe der Datenbindung festlegen, indem Sie AppNotificationProgressBar.BindValueStringOverride aufrufen. Aktualisieren Sie den gebundenen Statuswert, indem Sie der Eigenschaft AppNotification.Progressein AppNotificationProgressData-Objekt zuweisen.

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.

Gilt für: