PasswordBox.PasswordRevealMode プロパティ

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;
    }
}

注釈

パスワードを隠すために使用する文字を変更するには、 PasswordChar プロパティを設定します。

覗き見モード

既定では、パスワード表示ボタン (または "ピーク" ボタン) が表示されます。 ユーザーは、高レベルのセキュリティが維持されるように、パスワードを表示するためにボタンを継続的に押す必要があります。

このプロパティの値は、パスワード表示ボタンがユーザーに表示されるかどうかを決定する唯一の要素ではありません。 その他の要因としては、コントロールが最小幅を超えて表示されるかどうか、 PasswordBox にフォーカスがあるかどうか、テキスト入力フィールドに少なくとも 1 文字が含まれているかどうかなどがあります。 セキュリティ上の理由から、パスワード表示ボタンは、 PasswordBox が初めてフォーカスを受け取り、文字が入力されたときにのみ表示されます。 PasswordBox がフォーカスを失い、フォーカスが回復した場合、パスワードがクリアされ、文字入力がやり直されない限り、表示ボタンは再び表示されません。

隠しモードと表示モード

その他の PasswordRevealMode 列挙値 ( Hidden と Visible) は、パスワード表示ボタンを非表示にして、パスワードが隠れているかどうかをプログラムで管理できるようにします。

常にパスワードを隠すには、 PasswordRevealMode を Hidden に設定します。 パスワードを常に隠す必要がない限り、ユーザーがHiddenとVisibleの間でPasswordRevealModeを切り替えることができるカスタム UI を提供できます。 CheckBox を使用してパスワードが隠れているかどうかを切り替える方法については、「例」セクションを参照してください。 ToggleButton などの他のコントロールを使用して、ユーザーがモードを切り替えることもできます。

こちらもご覧ください

• PasswordRevealMode