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.
Dient zum Abrufen oder Festlegen eines Werts, der die Einstellung eines Steuerelements angibt, ob Sounds wiedergegeben werden.
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 Aufzählung, die die Einstellung eines Steuerelements für die Wiedergabe von Sounds angibt. Der Standardwert ist "Auto".
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 Sounddesignleitfaden.
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 Anforderungsblock weiter unten auf dieser Seite angezeigte "Eingeführte Version" ist, müssen Sie Ihre App entwerfen und testen, um dies zu berücksichtigen. Weitere Informationen finden Sie unter versionsadaptiven 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 mithilfe der ApiInformation-Klasse überprüfen, ob diese Eigenschaft vorhanden ist, 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;
}
}