PasswordBox.PasswordRevealMode 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
암호가 항상, 절대 또는 선택적으로 가려지는지 여부를 지정하는 값을 가져오거나 설정합니다.
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
속성 값
암호가 항상, 절대 또는 선택적으로 가려지는지 여부를 지정하는 열거형의 값입니다. 기본값은 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 속성을 설정합니다.
미리 보기 모드
기본적으로 암호 표시 단추(또는 "미리 보기" 단추)가 표시됩니다. 사용자는 암호를 보기 위해 단추를 계속 눌러야 하므로 높은 수준의 보안이 유지됩니다.
![암호가 표시된 암호 상자입니다.](windows.ui.xaml.controls/images/passwordbox_revealed.png?view=winrt-26100)
이 속성의 값은 암호 표시 단추가 사용자에게 표시되는지 여부를 결정하는 유일한 요소가 아닙니다. 다른 요인으로는 컨트롤이 최소 너비 이상으로 표시되는지 여부, PasswordBox 에 포커스가 있는지 여부 및 텍스트 입력 필드에 하나 이상의 문자가 포함되어 있는지 여부가 포함됩니다. 보안상의 이유로 암호 표시 단추는 PasswordBox 가 처음으로 포커스를 받고 문자를 입력할 때만 표시됩니다. PasswordBox가 포커스를 잃고 포커스를 다시 얻으면 암호가 지워지고 문자 입력이 다시 시작되지 않는 한 표시 단추가 다시 표시되지 않습니다.
참고
Windows 10 전에는 암호 표시 단추가 기본적으로 표시되지 않았습니다. 앱의 보안에 암호가 항상 가려져야 하는 경우 PasswordRevealMode를 Hidden으로 설정해야 합니다.
숨김 및 표시 모드
다른 PasswordRevealMode 열거형 값 Hidden 및 Visible는 암호 표시 단추를 숨기고 암호가 가려지는지 여부를 프로그래밍 방식으로 관리할 수 있도록 합니다.
암호를 항상 가리려면 PasswordRevealMode를 숨김으로 설정합니다. 암호를 항상 가려야 하는 경우가 아니면 사용자가 Hidden 과 Visible 간에 PasswordRevealMode를 토글할 수 있도록 사용자 지정 UI를 제공할 수 있습니다.
이전 버전의 Windows Phone PasswordBox는 CheckBox를 사용하여 암호가 가려졌는지 여부를 토글했습니다. 예제와 같이 앱에 대해 유사한 UI를 만들 수 있습니다. ToggleButton과 같은 기타 컨트롤을 사용하여 사용자가 모드 간을 전환하도록 할 수도 있습니다.
![사용자 지정 표시 토글이 있는 암호 상자입니다.](windows.ui.xaml.controls/images/passwordbox_customreveal.png?view=winrt-26100)