Sugerencias para la aplicación de estilos al control PasswordBox

El control PasswordBox representa un objeto que puede recibir los datos proporcionados por el usuario a la vez que enmascara los caracteres que va escribiendo.

Al igual que con los demás controles, el control PasswordBox se puede modificar para que muestre una apariencia muy distinta a la predeterminada. La apariencia predeterminada del control PasswordBox es la siguiente:

Propiedades de interés del control PasswordBox

El control PasswordBox es un control de texto. Si desea presentar el control PasswordBox con caracteres, modifique la propiedad Password en la categoría Propiedades comunes del panel Propiedades. La propiedad Password albergará el texto que el usuario escriba.

Para cambiar el carácter de enmascaramiento que aparece cuando el usuario escribe texto en el control PasswordBox, cambie la propiedad PasswordChar, que aparece cuando hace clic en Mostrar propiedades avanzadas  en la parte inferior de la categoría Texto del panel Propiedades.

Puede establecer estas propiedades de varias formas:

• Establecer las propiedades del objeto   Después de dibujar un objeto PasswordBox en la mesa de trabajo, puede establecer las propiedades del objeto directamente. Si desea que varios objetos PasswordBox usen los mismos valores, establezca estas propiedades en un estilo.

• Establecer las propiedades en un estilo   Si establece estas propiedades en el estilo del objeto PasswordBox, todos los objetos PasswordBox que usen ese estilo usarán esos valores. Puede sobrescribir los valores de un objeto específico.

  Para obtener más información, vea Crear un estilo.

Para especificar lo que ocurre cuando el usuario escribe una contraseña en el control PasswordBox, enlace el evento PasswordChanged a un controlador de eventos.

Para obtener más información, vea Escribir código que responda a eventos.

Elementos de la plantilla PasswordBox

El control PasswordBox usa una plantilla para definir su apariencia: la plantilla PasswordBox. Cada elemento de la plantilla desempeña un papel en la apariencia y el comportamiento del objeto PasswordBox al que se aplica la plantilla.

En la plantilla, pueden existir otros objetos para adornar la apariencia del control PasswordBox, pero los elementos enumerados en la tabla siguiente están asociados a su comportamiento en un contrato.

Para ver los elementos de una plantilla, abra el panel Elementos al modificar la plantilla. En el panel Objetos y escala de tiempo, aparece un icono junto a cada objeto que está actuando como elemento en el panel Elementos.

Nombre de elemento	Tipo de objeto	Descripción
ContentElement	FrameworkElement	Objeto que muestra caracteres de enmascaramiento conforme el usuario escribe una contraseña. Este elemento es obligatorio.

Los demás objetos de la plantilla PasswordBox se usan para cambiar la apariencia del control PasswordBox en varios estados.

Estados del control PasswordBox

De forma predeterminada, el control PasswordBox puede estar en uno de los cuatro estados del grupo de estados CommonStates, que se pueden ver en el panel Estados al modificar una plantilla PasswordBox:

Nombre del estado	Descripción
Normal	Apariencia del control PasswordBox cuando no hay ninguna interacción con el control.
MouseOver	Apariencia del control PasswordBox cuando el usuario mueve el puntero sobre él.
Pressed	Apariencia del control PasswordBox cuando el usuario hace clic en él, o cuando el control recibe el foco y el usuario presiona ENTRAR o BARRA ESPACIADORA.
Disabled	Apariencia del control PasswordBox cuando la propiedad IsEnabled se ha establecido en False.

El control PasswordBox puede estar en uno de los dos estados siguientes del grupo de estados FocusStates:

Nombre del estado	Descripción
Unfocused	Apariencia del control PasswordBox cuando no recibe el foco del teclado.
Focused	Apariencia del control PasswordBox cuando recibe el foco del teclado. Por ejemplo, es posible que un usuario presione la tecla TAB para recorrer los objetos de su aplicación hasta que el foco del teclado esté en el control PasswordBox.

El control PasswordBox puede estar en uno de los tres estados siguientes del grupo de estados ValidationStates:

Nombre del estado	Descripción
Valid	Apariencia del control PasswordBox cuando es válido.
InvalidUnfocused	Apariencia del control PasswordBox cuando no es válido y no tiene el foco del teclado.
InvalidFocused	Apariencia del control PasswordBox cuando no es válido y tiene el foco del teclado.

Sugerencia:

Un grupo de estados contiene los estados visuales que forman parte de la misma categoría lógica y que no se pueden mostrar al mismo tiempo. Por ejemplo, el grupo CommonStates incluye estados relacionados con la interacción del usuario mediante un dispositivo de entrada como el mouse. Solo se puede mostrar un estado de este grupo de estados cada vez, pero un estado de un grupo sí se puede mostrar al mismo tiempo que un estado de otro grupo de estados.

Al seleccionar un estado, se activa la grabación del estado y se grabarán todos los cambios que se realicen para dicho estado. Para desactivar la grabación del estado, haga clic en el botón de grabación o seleccione Base en el panel Estados. Para modificar la apariencia del control cuando dos estados diferentes están activos, puede anclar una vista previa de un estado de un grupo de estados mientras modifica un estado de otro grupo de estados.

Para convertir objetos en un control PasswordBox

Para modificar la plantilla de un control PasswordBox, realice una de las siguientes acciones:

• Dibuje un control PasswordBox  en la mesa de trabajo y, a continuación, cree una copia de la plantilla predeterminada.

  Para obtener más información, vea Crear o modificar una plantilla.

• Diseñe el aspecto del control PasswordBox dibujando objetos o importando material gráfico y, a continuación, use el comando Convertir en control.

Si usa el comando Convertir en control, siga los pasos que se indican a continuación para asegurarse de crear todos los objetos que la plantilla del control PasswordBox requiere:

1. Agrupe los objetos en un panel de diseño, seleccione el panel de diseño y, a continuación, en el menú Herramientas, haga clic en Convertir en control.

2. En el cuadro de diálogo que aparece, seleccione PasswordBox, asígnele un nombre a la plantilla y seleccione la ubicación donde se almacenará.

   Para obtener información acerca de las ubicaciones, vea Crear un recurso.

3. Después de hacer clic en Aceptar, Microsoft Expression Blend entra en el modo de edición de plantilla y muestra los objetos que forman el control PasswordBox.

4. Si la plantilla incluye un objeto en el que desea mostrar texto, como un objeto TextBlock, haga clic con el botón secundario en el objeto, elija Convertir en elemento de PasswordBox, y haga clic en ContentElement. De lo contrario, en el panel Elementos, haga doble clic en el elemento ContentElement para crear un objeto Grid en la plantilla que actúe como elemento ContentElement. Modifique las propiedades de la categoría Diseño del panel Propiedades para mostrar el nuevo objeto Grid donde desea que esté.

5. Puede seguir modificando la plantilla en el modo de edición de plantilla. Por ejemplo, agregar o modificar objetos, o bien seleccionar un estado en el panel Estados para modificar la apariencia de la plantilla en dicho estado.

6. Plantéese la posibilidad de enlazar algunas de las propiedades de pincel de los objetos de la plantilla a las siguientes propiedades del objeto PasswordBox que finalmente usará la plantilla:

   • Background

   • BorderBrush

   • Foreground

   • BorderThickness

   Para obtener más información, vea Trasladar propiedades de objetos a la plantilla.

7. Para salir del modo de edición de plantilla, haga clic en [PasswordBox] en la barra de ruta de navegación situada en la parte superior de la mesa de trabajo, o haga clic en Ámbito superior en el panel Objetos y escala de tiempo.

Para obtener información acerca de cómo aplicar una plantilla PasswordBox nueva a otros objetos PasswordBox, vea Aplicar o quitar un recurso.

Referencias

Encontrará información detallada acerca de las propiedades y eventos del control PasswordBox de Microsoft Silverlight en la galería de controles de Silverlight (puede estar en inglés) en MSDN.

Vea también

Conceptos

Sugerencias para la aplicación de estilos a controles Silverlight comunes

Aplicar estilos a un control que admite plantillas

Dibujar texto