Conseils de conception de styles pour le contrôle PasswordBox

Le contrôle PasswordBox représente un objet qui peut obtenir une entrée d'un utilisateur tout en masquant les caractères tapés par celui-ci.

Comme tout contrôle, le contrôle PasswordBox peut être modifié et son aspect peut devenir très différent de son apparence par défaut. Par défaut, le contrôle PasswordBox a l'aspect suivant :

Propriétés intéressantes du contrôle PasswordBox

Le contrôle PasswordBox est un contrôle de texte. Si vous voulez présenter le contrôle PasswordBox avec des caractères présents dans celui-ci, vous pouvez modifier la propriété Password (mot de passe) sous Propriétés communes dans le panneau Propriétés. La propriété Password retient le texte saisi par l'utilisateur.

Vous pouvez modifier le caractère de masquage qui s'affiche lorsque les utilisateurs tapent du texte dans le contrôle PasswordBox en modifiant la propriété PasswordChar qui s'affiche lorsque vous cliquez sur Afficher les propriétés avancées  à la partie inférieure de la Catégorie Texte du panneau Propriétés.

Vous pouvez modifier ces propriétés comme suit :

• Définir les propriétés de l'objet   Lorsque vous avez dessiné un objet PasswordBox sur la planche graphique, vous pouvez définir directement les propriétés de l'objet. Si vous voulez que plusieurs objets PasswordBox utilisent les mêmes valeurs, vous pouvez définir ces propriétés dans un style.

• Définir les propriétés dans un style   Si vous définissez ces propriétés dans le style  de l'objet PasswordBox, tout objet PasswordBox qui utilise ce style utilisera ces valeurs. Vous pouvez remplacer les valeurs d'un objet spécifique.

  Pour plus d'informations, voir Créer un style.

Pour spécifier ce qui se produit lorsque l'utilisateur entre un mot de passe dans le contrôle PasswordBox, associez l'événement PasswordChanged à un gestionnaire d'événements.

Pour plus d'informations, voir Écriture de code de gestion des événements.

Parties du modèle PasswordBox

Le contrôle PasswordBox utilise un modèle pour définir son aspect : le PasswordBox Template. Chaque partie du modèle joue un rôle dans l'aspect et le comportement de l'objet PasswordBox auquel le modèle est appliqué.

D'autres objets peuvent exister dans le modèle pour habiller le contrôle PasswordBox, mais les parties répertoriées dans le tableau suivant sont liées à son comportement dans un contrat.

Pour afficher les parties du modèle, ouvrez le panneau Parties tout en modifiant le modèle. Dans le panneau Objets et chronologie, une icône  s'affiche à côté de tout objet qui joue le rôle d'une partie dans le panneau Parties.

Nom de la partie	Type d'objet	Description
ContentElement	FrameworkElement	Objet qui affiche les caractères de masquage lorsque l'utilisateur tape un mot de passe. Cette partie est obligatoire.

Les autres objets du modèle PasswordBox sont utilisés pour modifier l'aspect du contrôle PasswordBox dans divers états.

États du contrôle PasswordBox

Par défaut, le contrôle PasswordBox peut se trouver dans l'un des 4 états suivants dans le groupe des états CommonStates qui est visible dans le panneau États lors de la modification d'un modèle PasswordBox :

Nom de l'état	Description
Normal	Aspect du contrôle PasswordBox en l'absence d'interaction avec ce dernier.
MouseOver	Aspect du contrôle PasswordBox lorsque l'utilisateur place le pointeur dessus.
Enfoncé	Aspect du contrôle PasswordBox lorsque l'utilisateur clique dessus ou lorsque le contrôle est activable et que l'utilisateur appuie sur Entrée ou Espace.
Désactivé	Aspect du contrôle PasswordBox lorsque la propriété IsEnabled a pour valeur False.

Le contrôle PasswordBox peut être dans l'un des deux états suivants du groupe des états FocusStates :

Nom de l'état	Description
Sans focus	Aspect du contrôle PasswordBox lorsqu'il ne possède pas le focus clavier.
Avec focus	Aspect du contrôle PasswordBox lorsqu'il possède le focus clavier. Un utilisateur pourrait, par exemple, appuyer sur la touche Tabulation pour parcourir en séquence les objets d'une application jusqu'à ce que le focus clavier soit sur le contrôle PasswordBox.

Le contrôle PasswordBox peut se trouver dans l'un des 3 états suivants du groupe des états ValidationStates :

Nom de l'état	Description
Valide	Aspect du contrôle PasswordBox lorsqu'il est valide.
InvalidUnfocused	Aspect du contrôle PasswordBox lorsqu'il n'est pas valide et ne possède pas le focus clavier.
InvalidFocused	Aspect du contrôle PasswordBox lorsqu'il n'est pas valide et possède le focus clavier.

Conseil :

Un groupe d'états contient les états visuels qui appartiennent à une même catégorie logique et qui ne peuvent pas être affichés en même temps. Le groupe CommonStates par exemple comprend des états qui se rapportent à une interaction utilisateur avec un périphérique d'entrée tel que la souris. Un seul état d'un groupe d'états peut être affiché à la fois, mais un état d'un groupe peut être affiché en même temps qu'un état d'un autre groupe d'états.

Lorsque vous sélectionnez un état, l'enregistrement de l'état est activé et toutes les modifications que vous effectuez sont enregistrées pour cet état. Pour arrêter l'enregistrement de l'état, cliquez sur le bouton d'enregistrement ou sélectionnez Base dans le panneau États. Pour modifier l'apparence de votre contrôle lorsque deux états séparés sont actifs, vous pouvez afficher un aperçu d'un état dans un groupe d'états pendant que vous modifiez un état dans un groupe d'états différent.

Pour convertir des objets en contrôle PasswordBox

Pour modifier le modèle d'un contrôle PasswordBox, effectuez l'une des opérations suivantes :

• Dessinez un PasswordBox  sur la planche graphique, puis créez une copie du modèle par défaut.

  Pour plus d'informations, voir Créer ou modifier un modèle.

• Créez l'aspect de votre contrôle PasswordBox en dessinant des objets ou en important des éléments graphiques, puis utilisez la commande Créer un contrôle.

Si vous utilisez la commande Créer un contrôle, suivez la procédure suivante pour être sûr de créer tous les objets requis par le modèle contrôle PasswordBox :

1. Regroupez vos objets dans un panneau de disposition, sélectionnez ce dernier, puis, dans le menu Outils, cliquez sur Créer un contrôle.

2. Dans la boîte de dialogue qui s'affiche, sélectionnez PasswordBox, donnez un nom à votre modèle et sélectionnez l'emplacement où le modèle sera stocké.

   Pour plus d'informations sur les emplacements, voir Créer une ressource.

3. Lorsque vous cliquez sur OK, Microsoft Expression Blend entre dans le mode de modification de modèle et affiche les objets qui forment votre contrôle PasswordBox.

4. Si votre modèle comprend un objet dans lequel vous voulez afficher du texte, comme un objet TextBlock, cliquez avec le bouton droit sur l'objet, pointez sur Créer une partie de PasswordBox, puis cliquez sur ContentElement. Sinon, dans le panneau Parties, double-cliquez sur la partie ContentElement pour créer un objet Grid dans votre modèle pour qu'il joue le rôle de partie ContentElement. Modifiez les propriétés dans la catégorie Disposition du panneau Propriétés pour afficher le nouvel objet Grid à l'emplacement souhaité.

5. Vous pouvez continuer à modifier votre modèle dans le mode de modification de modèle. Par exemple, ajoutez ou modifiez des objets, ou sélectionnez un état dans le panneau États pour modifier l'apparence de votre modèle dans cet état.

6. Envisagez de lier certaines propriétés du pinceau des objets de votre modèle aux propriétés suivantes de l'objet PasswordBox que votre modèle utilisera in fine :

   • Background

   • BorderBrush

   • Foreground

   • BorderThickness

   Pour plus d'informations, voir Véhiculer des propriétés d'objet vers le modèle.

7. Pour sortir du mode de modification de modèle, cliquez sur [PasswordBox] dans la barre de navigation en haut de la planche graphique, ou cliquez sur Étendue supérieure  dans le panneau Objets et chronologie.

Pour plus d'informations sur l'application de votre nouveau modèle PasswordBox à d'autres objets PasswordBox, voir Appliquer ou supprimer une ressource.

Références

Des informations détaillées sur les propriétés et les événements du contrôle PasswordBox Microsoft Silverlight sont disponibles à la rubrique Silverlight Control Gallery (galerie des contrôles Silverlight) sur MSDN.

Voir aussi

Concepts

Conseils de conception de styles pour les contrôles Silverlight courants

Définition d'un style pour un contrôle prenant en charge les modèles

Dessiner du texte