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

プロパティ値

パスワードが常に、決して、または必要に応じて隠れているかどうかを指定する列挙体の値。 既定値は [ピーク] です。

例

この例では、 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 にフォーカスがあるかどうか、テキスト入力フィールドに少なくとも 1 文字が含まれているかどうかなどがあります。 セキュリティ上の理由から、パスワード表示ボタンは、 PasswordBox が初めてフォーカスを受け取り、文字が入力された場合にのみ表示されることに注意してください。 PasswordBox がフォーカスを失い、フォーカスが回復した場合、パスワードがクリアされ、文字入力がやり直されない限り、表示ボタンは再び表示されません。

非表示モードと表示モード

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

常にパスワードを隠すには、PasswordRevealMode を [非表示] に設定します。 パスワードを常に隠す必要がない限り、カスタム UI を指定して、ユーザーが PasswordRevealMode を [非表示 ] と [ 表示] の間で切り替えることができます。

以前のバージョンのWindows Phoneでは、PasswordBox は CheckBox を使用して、パスワードが隠れているかどうかを切り替えていました。 この例に示すように、アプリ用に同様の UI を作成できます。 ToggleButton などのその他のコントロールを使ってユーザーがモードを切り替えられるようにすることもできます。

適用対象

こちらもご覧ください

• PasswordRevealMode