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
プロパティ値
パスワードが常に、決して、または必要に応じて隠れているかどうかを指定する列挙体の値。 既定値は プレビュー です。
例
この例では、 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;
}
}
注釈
パスワードを隠すために使用する文字を変更するには、 PasswordChar プロパティを設定します。
注意
PasswordRevealMode は IsPasswordRevealButtonEnabled に置き換えられ、ユーザーが自分のパスワードを表示する方法に関するより多くのオプションが提供されます。 IsPasswordRevealButtonEnabled プロパティは無視されます。
プレビュー モード
既定で表示されるパスワード表示ボタン ("プレビュー" ボタン) では、 ユーザーがパスワードを表示するにはボタンを押し続けなければならないため、高レベルのセキュリティが維持されます。
このプロパティの値は、パスワード表示ボタンがユーザーに表示されるかどうかを決定する唯一の要素ではありません。 その他の要因としては、コントロールが最小幅より上に表示されるかどうか、 PasswordBox にフォーカスがあるかどうか、テキスト入力フィールドに少なくとも 1 つの文字が含まれているかどうかなどがあります。 セキュリティ上の理由から、パスワード表示ボタンは、 PasswordBox が初めてフォーカスを受け取り、文字が入力されたときにのみ表示されます。 PasswordBox でフォーカスが失われ、フォーカスが回復した場合、パスワードがクリアされ、文字入力がやり直されない限り、表示ボタンは再び表示されません。
![パスワードが表示されたパスワード ボックス。](microsoft.ui.xaml.controls/images/passwordbox_revealed.png?view=windows-app-sdk-1.5)
非表示モードと表示モード
もう 1 つの PasswordRevealMode 列挙値 と Visible
は、パスワード表示ボタンを非表示にし、Hidden
パスワードが隠されているかどうかをプログラムで管理できるようにします。
常にパスワードを隠すには、 を に設定 PasswordRevealMode
します Hidden
。 パスワードを常に隠す必要がない限り、ユーザーが と Visible
を切り替えることができるカスタム UI をPasswordRevealMode
Hidden
提供できます。
CheckBox を使用してパスワードが隠れているかどうかを切り替える方法については、「例」セクションを参照してください。
ToggleButton などのその他のコントロールを使ってユーザーがモードを切り替えられるようにすることもできます。
![ユーザー設定の表示トグルを含むパスワード ボックス。](microsoft.ui.xaml.controls/images/passwordbox_customreveal.png?view=windows-app-sdk-1.5)