lunes, 19 de diciembre de 2011

Entendiendo las propiedades de dependencia en Silverligth

He decidido escribir este post, como ayuda para la cápsula de Silverligt relacionada con la implementación de Content Controls, en donde se requiere definir para el Content Control una propiedad de este tipo.

Haber, las propiedades de dependencia, aunque sin de pronto saberlo, las has usado cada vez que le asignas su valor a una propiedad de las principales de los controles que hemos visto: TextBox, CheckBox, Button o TextBlock. Ello porque las propiedades principales de los controles que mayormente usamos, todas permiten en un momento determinado la aplicación de: Animaciones, Estilos o Enlace a datos, como se verá en otras cápsulas.

Las propiedades de dependencia son entonces propiedades que permiten extender la funcionalidad de la propia propiedad. Es decir, tomemos como ejemplo, la propiedad Text del control TextBlock. Con esta propiedad, podemos definir el texto que muestra el TextBlock, allí usamos la funcionalidad normal de la propiedad Text. Sin embargo, como veremos en cápsulas sucesivas, se puede utilizar la propiedad Text, para mostrar la información proveniente de una fuente de datos, es decir, podemos enlazar la propiedad a una fuente de datos con una sintaxis dada:

<TextBlock Text="{Binding Team.TeamName}"/>

En este caso, la propiedad Text se enlaza a una fuente de datos, para tomar el nombre de un equipo.

Por ello, la propiedad Text es una propiedad de dependencia, porque, en un momento dado, permite extender su funcionalidad básica que es definir el texto para el TextBlock y, en este caso particular, enlazarse previamente a una fuente de datos para tomar la información.

Los objetos o controles de Silverligt son objetos DependencyObject y deben serlo porque la mayoría de ellos permiten la animación, enlazado a datos o la aplicación de estilos de al menos una propiedad y para permitir dichas acciones sobre la propiedad éstas deben ser propiedades de dependencia que solo se pueden definir en objetos de dependencia.

Para que un objeto permita en una propiedad de dependencia, el enlazado a datos, debe también heredar de FrameworkElement.

En el caso del TextBlock, podemos enlazar la propiedad Text a una fuente de datos y como muestra la imagen, vemos, en su jerarquía de clase, que hereda de FrameworkElement:

JerarquiaHerenciaTextBlock

También, vemos como es un DependencyObject.

En Silverligth, nosotros podemos definir nuestras propias propiedades de dependencia para proporcionarles a los Content Controles, User Controls o demás tipos de controles que implementemos, propiedades que permitan el enlazado de datos, el establecimiento de animaciones o la aplicación de estilos cuando sea requerido.

Las propiedades de dependencia se definen, en código, de manera similar a las propiedades convencionales clásicas que se respaldaban en un campo privado. A continuación, el comparativo:

Propiedad clásica convencional

Propiedad de dependencia

private bool isSpinning;

 

 

 

 

 

public bool IsSpinning

{

get { return isSpinning;}

set { isSpinning = value;}

}

public static readonly DependencyProperty IsSpinningProperty =

DependencyProperty.Register(

"IsSpinning", typeof(Boolean),

typeof(SilverlightExampleClass), null

);

 

public bool IsSpinning

{

get { return (bool)GetValue(IsSpinningProperty); }

set { SetValue(IsSpinningProperty, value); }

}

Es decir, en lugar del campo privado se usa el tipo DependencyProperty estático público y de solo lectura, que por convención lleva el nombre de la propiedad de dependencia seguido del término Property (<NombrePropiedad>Property. Ejemplo:IsSpinningProperty);  y para obtener y asignar el valor de la propiedad se deben usar los métodos GetValue y SetValue.

También notar como la propiedad de dependencia se debe registrar utilizando el método DependencyProperty.Register.

Que recibe como parámetros:

  • El nombre de la propiedad de dependencia a registrar
  • Su tipo
  • El tipo de la clase donde se registra la propiedad de dependencia
  • Y, por último, de manera opcional, información de metadata de la propiedad de dependencia.

En resumen, entonces, tenemos que las propiedades de dependencia permiten extender la funcionalidad de la propiedad para permitir: Animaciones, enlace a datos o aplicación de estilos. Sin embargo, las propiedades de dependencia presentan otra característica importante y es la de proporcionar devoluciones de llamada que puedan propagar sus cambios a otras propiedades. Es decir, las devoluciones de llamada se pueden utilizar para notificar o cambiar los valores de las propiedades relacionadas, de un modo sincrónico en general.

Para usar las devoluciones de llamada, las definimos en la información de metadata del método de registro. Por ejemplo:

public static readonly DependencyProperty HeaderContentProperty =
    DependencyProperty.Register("HeaderContent", typeof(object), typeof(MiContentControl),
    new PropertyMetadata(new TextBlock() { Text="Usar un TextBlock"}, new PropertyChangedCallback(OnHeaderContentChanged)));
 
static void OnHeaderContentChanged(DependencyObject sender, DependencyPropertyChangedEventArgs e)
{
    MiContentControl miContentControl = (MiContentControl)sender;
 
    if (!(e.NewValue is TextBlock))
    {
        miContentControl.ClearValue(HeaderContentProperty);
    }
}
 
public object HeaderContent { 
    get { return (object)GetValue(HeaderContentProperty); } 
    set { SetValue(HeaderContentProperty, value); } 
}



Notar como, en este caso, definimos valor para la información de Metadata, en el método de registro:


new PropertyMetadata(new TextBlock() { Text="Usar un TextBlock"}, new PropertyChangedCallback(OnHeaderContentChanged))


El objeto PropertyMetadata recibe dos parámetros:



  • El valor por defecto de la propiedad. Que para el caso es:

        new TextBlock() { Text="Usar un TextBlock"}



  • La definición de la devolución de la llamada. Y corresponde a:

         new PropertyChangedCallback(OnHeaderContentChanged)


Es en la implementación de la devolución de llamada donde se puede hacer la modificación de las propiedades relacionadas con base al valor de la propiedad de dependencia.


En el ejemplo, la implementación de la devolución de la llamada corresponde a:




static void OnHeaderContentChanged(DependencyObject sender, DependencyPropertyChangedEventArgs e)
{
    MiContentControl miContentControl = (MiContentControl)sender;
 
    if (!(e.NewValue is TextBlock))
    {        
 
       //Se asigna de nuevo como valor de la propiedad el definido por defecto
        miContentControl.ClearValue(HeaderContentProperty);
    }
}


Donde se define lo que ocurre cuando se modifica el encabezado de un Content Control.

Por defecto (resaltado de azul), se define que su valor será un TextBlock con el texto: Usar un TextBlock y en la implementación de la devolución de llamada, se controla que si el valor de la propiedad, luego de modificado por el usuario (NewValue), no es un TextBlock; se le asigna su valor por defecto. Esto se logra al llamar el método ClearValue pasándole como parámetro la propiedad de dependencia.

De esta forma, se usa la devolución de llamada, para controlar que solo se pueda usar un TextBlock como encabezado.

El código precedente, entonces, también ilustra otras características que poseen las propiedades de dependencia que son: la posibilidad de definirles un valor por defecto y la posibilidad de restablecer ese valor por defecto, en cualquier momento, por medio del método ClearValue que recibe como parámetro la propiedad de dependencia.

Finalmente, como también es ilustrado, en la implementación de la devolución de la llamada podemos acceder a la información de los distintos valores de la propiedad de dependencia para la toma de decisiones:

NewValue: Valor después de realizado el cambio del valor de la propiedad de dependencia.

OldValue: Valor de la propiedad antes de realizado el cambio.

Resumen, en mapa conceptual:

ResumenPropiedadDependencia

martes, 13 de diciembre de 2011

Base de conocimiento

Categoría
Descripción
Observación
Silverligth La propiedad FontStretch del TextBlock y TextBox se encuentra definida solo por compatibilidad con WPF. En Silverligth esta propiedad no tiene efecto, ni siquiera para fuentes OpenType como era en el caso de WPF. http://forums.silverlight.net/
p/126686/284601.aspx

Silverligth En lo que respecta a la programación asíncrona, en Silverligth, no es soportada la forma de llamar al método BeginInvoke desde un delegado.

Delegate.BeginInvoke

 

martes, 6 de diciembre de 2011

Otros controles contenedores – WrapPanel

En esta cápsula estudiaremos otro contenedor de controles, el WrapPanel. El WrapPanel al igual que el DockPanel no es un control de los básicos que se pueden usar con solo instalar SilverLigth (como si lo son Canvas, StackPanel y Grid). Para poder usar el WrapPanel debes instalar si no los has hecho el ToolKit para Silverligth 4. El Toolkit lo puedes obtener de la siguiente dirección:

http://silverlight.codeplex.com/releases/view/43528

Si deseas más información sobre este control contenedor, puedes visitar el sitio:

http://msdn.microsoft.com/es-es/library/system.windows.controls.wrappanel.aspx

Estudio del control WrapPanel

Si tienen comentarios, sugerencias o preguntas. Favor, realizarlas, estaré atento para colaborarles en lo que pueda.

lunes, 5 de diciembre de 2011

Otros controles contenedores – DockPanel

 

Motivado por la comunidad a la que pertenezco Avanet, he comenzado a realizar una serie  de videos de enseñanza o pequeñas cápsulas de conocimiento sobre un tema, para mi apasionante, Silverligth.

La idea es ir abordando tema tras tema de una forma tranquila y lograr así el entendimiento general sobre el mismo.

A continuación, entonces, la primera:

En esta cápsula estudiaremos el DockPanel. El DockPanel a diferencia que en WPF (Windows Presentation Foundation) no es un control de los básicos que se pueden usar con solo instalar SilverLigth (como si lo son Canvas, StackPanel y Grid). Para poder usar el DockPanel debes instalar si no los has hecho el ToolKit para Silverligth 4. El Toolkit lo puedes obtener de la siguiente dirección:

http://silverlight.codeplex.com/releases/view/43528

Si deseas más información sobre este control contenedor, puedes visitar el sitio:

http://msdn.microsoft.com/es-es/library/system.windows.controls.dockpanel.aspx

Explicación del uso del control DockPanel en SilverLigth

Si tienen comentarios, sugerencias o preguntas. Favor, realizarlas, estaré atento para colaborarles en lo que pueda.