Control.ElementSoundMode 속성

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

소리를 재생할지 여부에 대한 컨트롤의 기본 설정을 지정하는 값을 가져오거나 설정합니다.

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"/>

속성 값

ElementSoundMode

소리 재생 여부에 대한 컨트롤의 기본 설정을 지정하는 열거형의 값입니다. 기본값은 Auto입니다.

설명

ElementSoundMode 속성을 설정하여 특정 컨트롤에 대한 전역 ElementSoundPlayer 설정을 재정의합니다.

이 속성을 사용하는 방법에 대한 자세한 내용은 소리 디자인 지침을 참조하세요.

버전 호환성

ElementSoundMode 속성은 Windows 10 버전 1607 이전에는 사용할 수 없습니다. Microsoft Visual Studio에서 앱의 '최소 플랫폼 버전' 설정이 이 페이지의 뒷부분에 있는 요구 사항 블록에 표시된 '도입된 버전'보다 작은 경우 이를 고려하여 앱을 디자인하고 테스트해야 합니다. 자세한 내용은 버전 적응 코드를 참조하세요.

앱이 이전 버전의 Windows 10 실행되는 경우 예외를 방지하려면 XAML에서 이 속성을 설정하거나 런타임 검사 수행하지 않고 사용하지 마세요. 이 예제에서는 ApiInformation 클래스를 사용하여 설정하기 전에 이 속성이 있는지 검사 방법을 보여줍니다.

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

추가 정보

• ElementSoundPlayer
• 사운드 디자인 지침