PasswordBox.PasswordRevealMode Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Obtém ou define um valor que especifica se a senha é sempre, nunca ou opcionalmente obscurecida.

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

Valor da propriedade

PasswordRevealMode

Um valor da enumeração que especifica se a senha é sempre, nunca ou opcionalmente obscurecida. O padrão é Pré-visualizar.

Exemplos

Este exemplo mostra como usar uma CheckBox para permitir que um usuário alterne o modo de revelação de uma 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;
    }
}

Comentários

Para alterar o caractere usado para obscurecer a senha, defina a propriedade PasswordChar .

Observação

PasswordRevealMode substitui IsPasswordRevealButtonEnabled para fornecer mais opções de como o usuário é capaz de exibir sua senha. A propriedade IsPasswordRevealButtonEnabled é ignorada.

Modo espiada

Por padrão, o botão de revelação de senha (ou botão de "espiada") é exibido. O usuário deve pressionar continuamente o botão para exibir a senha, para que um alto nível de segurança seja mantido.

O valor dessa propriedade não é o único fator que determina se um botão de revelação de senha está visível para o usuário. Outros fatores incluem se o controle é exibido acima de uma largura mínima, se o PasswordBox tem foco e se o campo de entrada de texto contém pelo menos um caractere. Por motivos de segurança, o botão de revelação de senha é mostrado somente quando o PasswordBox recebe o foco pela primeira vez e um caractere é inserido. Se a PasswordBox perder o foco e, em seguida, recuperar o foco, o botão de revelação não será mostrado novamente, a menos que a senha seja desmarcada e a entrada de caractere comece novamente.

Modos ocultos e visíveis

Os outros valores Hidden de enumeração PasswordRevealMode e Visible, ocultam o botão de revelação de senha e permitem que você gerencie programaticamente se a senha está obscurecida.

Para sempre obscurecer a senha, defina PasswordRevealMode como Hidden. A menos que você precise que a senha seja sempre obscurecida, você pode fornecer uma interface do usuário personalizada para permitir que o usuário alterne entre PasswordRevealModeHidden e Visible. Consulte a seção Exemplos para ver como usar uma Caixa de Seleção para alternar se a senha está ocultada ou não. Você também pode usar outros controles, como ToggleButton, para deixar os usuários alternarem os modos.

Confira também

• PasswordRevealMode