Freigeben über

Control.ElementSoundMode Eigenschaft

  • Referenz

Definition

Namespace:
Windows.UI.Xaml.Controls
Bearbeiten

Ruft einen Wert ab, der die Einstellung eines Steuerelements für die Wiedergabe von Sounds angibt, oder legt diesen fest.

public:
 property ElementSoundMode ElementSoundMode { ElementSoundMode get(); void set(ElementSoundMode value); };
ElementSoundMode ElementSoundMode();

void ElementSoundMode(ElementSoundMode value);
public ElementSoundMode ElementSoundMode { get; set; }
var elementSoundMode = control.elementSoundMode;
control.elementSoundMode = elementSoundMode;
Public Property ElementSoundMode As ElementSoundMode
<control ElementSoundMode="elementSoundModeMemberName"/>

Eigenschaftswert

ElementSoundMode

Ein Wert der -Enumeration, der die Einstellung eines Steuerelements für die Wiedergabe von Sounds angibt. Der Standardwert ist Auto.

Windows-Anforderungen

Gerätefamilie
Windows 10 Anniversary Edition (eingeführt in 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v3.0)

Hinweise

Legen Sie die ElementSoundMode-Eigenschaft fest, um die globale ElementSoundPlayer-Einstellung für ein bestimmtes Steuerelement außer Kraft zu setzen.

Weitere Informationen zur Verwendung dieser Eigenschaft finden Sie unter Sound in UWP-Apps.

Versionskompatibilität

Die ElementSoundMode-Eigenschaft ist vor Windows 10 Version 1607 nicht verfügbar. Wenn die Einstellung "Mindestplattformversion" Ihrer App in Microsoft Visual Studio kleiner als die im Abschnitt "Anforderungen" weiter unten auf dieser Seite angezeigte "eingeführte Version" ist, müssen Sie die App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter Versionsadaptiver Code.

Um Ausnahmen zu vermeiden, wenn Ihre App in früheren Versionen von Windows 10 ausgeführt wird, legen Sie diese Eigenschaft nicht in XAML fest, oder verwenden Sie sie nicht, ohne eine Laufzeitüberprüfung durchzuführen. In diesem Beispiel wird gezeigt, wie Sie die ApiInformation-Klasse verwenden, um das Vorhandensein dieser Eigenschaft zu überprüfen, bevor Sie sie festlegen.

 private void MainPage_Loaded(object sender, RoutedEventArgs e)
 {
    if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "ElementSoundMode"))
    {
        button1.ElementSoundMode = ElementSoundMode.Off;
    }
}

Gilt für:

Weitere Informationen