PasswordBox.PasswordRevealMode 속성

정의

네임스페이스:

Windows.UI.Xaml.Controls

암호가 항상, 절대 또는 선택적으로 가려지는지 여부를 지정하는 값을 가져오거나 설정합니다.

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

PasswordRevealMode PasswordRevealMode();

void PasswordRevealMode(PasswordRevealMode value);

public PasswordRevealMode PasswordRevealMode { get; set; }

var passwordRevealMode = passwordBox.passwordRevealMode;
passwordBox.passwordRevealMode = passwordRevealMode;

Public Property PasswordRevealMode As PasswordRevealMode

속성 값

PasswordRevealMode

암호가 항상, 절대 또는 선택적으로 가려지는지 여부를 지정하는 열거형의 값입니다. 기본값은 Peek입니다.

예제

이 예제에서는 CheckBox 를 사용하여 사용자가 PasswordBox의 표시 모드를 전환할 수 있도록 하는 방법을 보여 줍니다.

<StackPanel Width="200">
    <PasswordBox Name="passwordBox1" 
                 PasswordRevealMode="Hidden"/>
    <CheckBox Name="revealModeCheckBox" Content="Show password"
              IsChecked="False" 
              Checked="CheckBox_Changed" Unchecked="CheckBox_Changed"/>
</StackPanel>

private void CheckBox_Changed(object sender, RoutedEventArgs e)
{
    if (revealModeCheckBox.IsChecked == true)
    {
        passwordBox1.PasswordRevealMode = PasswordRevealMode.Visible;
    }
    else
    {
        passwordBox1.PasswordRevealMode = PasswordRevealMode.Hidden;
    }
}

Private Sub CheckBox_Changed(sender As Object, e As RoutedEventArgs)
    If revealModeCheckBox.IsChecked = True Then
        passwordBox1.PasswordRevealMode = PasswordRevealMode.Visible
    Else
        passwordBox1.PasswordRevealMode = PasswordRevealMode.Hidden
    End If
End Sub

설명

PasswordRevealMode 는 IsPasswordRevealButtonEnabled 를 대체하여 사용자가 암호를 볼 수 있는 방법에 대한 추가 옵션을 제공합니다. IsPasswordRevealButtonEnabled 속성은 무시됩니다.

암호를 가리는 데 사용되는 문자를 변경하려면 PasswordChar 속성을 설정합니다.

미리 보기 모드

기본적으로 암호 표시 단추(또는 "미리 보기" 단추)가 표시됩니다. 사용자는 암호를 보기 위해 단추를 계속 눌러야 하므로 높은 수준의 보안이 유지됩니다.

이 속성의 값은 암호 표시 단추가 사용자에게 표시되는지 여부를 결정하는 유일한 요소가 아닙니다. 다른 요인으로는 컨트롤이 최소 너비 이상으로 표시되는지 여부, PasswordBox 에 포커스가 있는지 여부 및 텍스트 입력 필드에 하나 이상의 문자가 포함되어 있는지 여부가 포함됩니다. 보안상의 이유로 암호 표시 단추는 PasswordBox 가 처음으로 포커스를 받고 문자를 입력할 때만 표시됩니다. PasswordBox가 포커스를 잃고 포커스를 다시 얻으면 암호가 지워지고 문자 입력이 다시 시작되지 않는 한 표시 단추가 다시 표시되지 않습니다.

참고

Windows 10 전에는 암호 표시 단추가 기본적으로 표시되지 않았습니다. 앱의 보안에 암호가 항상 가려져야 하는 경우 PasswordRevealMode를 Hidden으로 설정해야 합니다.

숨김 및 표시 모드

다른 PasswordRevealMode 열거형 값 Hidden 및 Visible는 암호 표시 단추를 숨기고 암호가 가려지는지 여부를 프로그래밍 방식으로 관리할 수 있도록 합니다.

암호를 항상 가리려면 PasswordRevealMode를 숨김으로 설정합니다. 암호를 항상 가려야 하는 경우가 아니면 사용자가 Hidden 과 Visible 간에 PasswordRevealMode를 토글할 수 있도록 사용자 지정 UI를 제공할 수 있습니다.

이전 버전의 Windows Phone PasswordBox는 CheckBox를 사용하여 암호가 가려졌는지 여부를 토글했습니다. 예제와 같이 앱에 대해 유사한 UI를 만들 수 있습니다. ToggleButton과 같은 기타 컨트롤을 사용하여 사용자가 모드 간을 전환하도록 할 수도 있습니다.

추가 정보

• PasswordRevealMode