Control.ElementSoundMode Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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;
}
}