Como he mencionado anteriormente aquí y aquí, las aplicaciones de Silverlight pueden ser clientes de automatización, es decir, pueden invocar los servidores de automatización registrados en el sistema operativo Windows de la máquina del usuario.

Un requerimiento bastante común en aplicaciones de negocio es poder utilizar el escáner conectado desde nuestro aplicativo, para poder digitalizar una imagen y posteriormente serializarla a disco y/o presentarla en pantalla, etc.

En sistema operativo Windows contamos con WIA (Windows Image Acquisition), la cual es una plataforma que permite a nuestras aplicaciones interactuar con hardware de imágenes y también estandariza la interacción entre las aplicaciones y los escáneres, es decir, es un común denominador entre el manufacturero del dispositivo y tú como desarrollador.  WIA está presente en Windows desde Windows ME en adelante, y su versión más reciente es la 2.0.

Es importante notar que tu hardware debe ser compatible con WIA para que el código de ejemplo de este artículo funcione.  Revisa la documentación de tu escáner para conocer si existe compatibilidad.

WIA.CommonDialog

El objeto WIA.CommonDialog tiene diferentes métodos que nos ayudan a desplegar las cajas de diálogo para poder seleccionar un dispositivo de imagen, como una cámara o un escáner, y además para escanear una imagen.  Si creamos una referencia a este objeto por medio de la clase AutomationFactory, podemos fácilmente integrar capacidades de escaneo en nuestra aplicación de Silverlight.

El objeto WIA.CommonDialog tiene algunos métodos bastantes interesantes, los cuales se destacan en la siguiente tabla:

Por ejemplo, al ejecutar ShowSelectDevice(), se desplegará la siguiente caja de dialogo:

Nota cómo también se muestran las cámaras conectadas en el equipo.

Para nuestro código utilizaremos el método ShowAcquireImage().  Este método regresa un objeto de tipo WIA.ImageFile, que representa la imagen digitalizada.

El siguiente fragmento de código muestra el uso de este método para desplegar la caja de diálogo para escanear.

using (dynamic commonDialog = AutomationFactory.CreateObject("WIA.CommonDialog"))
{
    dynamic imageFile;

    try
    {
        imageFile = commonDialog.ShowAcquireImage();
    }
    catch (Exception originalException)
    {
        throw new Exception("El scanner no está listo", originalException);
    }

La siguiente ilustración muestra la caja de diálogo después de haber seleccionado la vista previa de la imagen a escanear (en mi caso, la portada de un disco bastante bueno que les recomiendo ampliamente )

Al hacer clic en el botón “Scan”, la imagen será digitalizada.

En este caso, estamos obteniendo la imagen escaneada y la guardamos en la variable llamada imageFile.  No obstante, en este momento la imagen aún no ha sido convertida a algún formato válido.  Para ello podemos utilizar otro objeto: WIA.ImageProcess.

WIA.ImageProcess

El objeto WIA.ImageProcess permite manejar la lista de filtros que deseamos aplicar para una imagen.  Un filtro en el contexto del objeto WIA.ImageProcess es una modificación a un objeto de tipo ImageFile.

En nuestro ejemplo, estamos creando una referencia al objeto WIA.ImageProcess, la cual guardaremos en una variable llamada imageProcess.  Posteriormente, agregamos a la colección de filtros el filtro Convert, el cual nos servirá para convertir el formato de la imagen escaneada a un formato conocido, en este caso JPEG.

El formato JPEG en WIA está representado por el GUID {B96B3CAE-0728-11D3-9D7B-0000F81EF32E}, por lo que es buena idea tenerlo en una variable: la variable wiaFormatJPEG.  Esto se lo indicamos a la propiedad FormatID del filtro Convert y finalmente aplicamos el filtro por medio de la ejecución del método Apply(), pasando como parámetro la imagen original.

using (dynamic imageProcess = AutomationFactory.CreateObject("WIA.ImageProcess"))
{
    imageProcess.Filters.Add(imageProcess.FilterInfos("Convert").FilterID);
    imageProcess.Filters[1].Properties("FormatID").Value = wiaFormatJPEG;

//wiaFormatJPEG es una cadena con el GUID descrito

    try
    {
        dynamic newImageFile = imageProcess.Apply(imageFile);
        //guardar a disco u obtener el Stream

     }

}
     

Ya con la nueva imagen convertida al formato JPEG podríamos obtener el Stream para poder usarlo en un BitmapImage, tal y como lo muestra la siguiente ilustración.

O si quisiéramos guardar la imagen a disco, sería muy sencillo hacer a través del método SaveFile().

string path = Environment.GetFolderPath(Environment.SpecialFolder.MyPictures);
string fullFileName = string.Format(@"{0}\{1}", path, fileName);

//fileName es el nombre del archivo

if (File.Exists(fullFileName))
    File.Delete(fullFileName);

newImageFile.SaveFile(fullFileName);

En este caso, se guardará la imagen escaneada, en formato JPEG, en la carpeta “My Pictures” de la máquina del usuario.

El proyecto

Para demostrar el acceso al sistema de archivos de la máquina del usuario crearemos una sencilla aplicación que muestre las imágenes de la carpeta “Mis Imágenes” en una lista y al hacer clic sobre cada una mostrar la imagen seleccionada.

Iniciaremos creando un nuevo proyecto de Silverlight 4 en Visual Studio .NET 2010 y lo nombraremos Demo.SL4.ConfianzaElevada.SistemaArchivos aceptando la opción predeterminada de crear un proyecto Web para probar la aplicación de Silverlight.

Además, necesitaremos configurar la aplicación para permitir la instalación Afuera del Navegador y será en la misma caja de diálogo de configuración en donde deberemos establecer el nivel de Confianza Elevada.  En el artículo anterior detallamos cómo hacer esto.

Enumerador SpecialFolder

Una vez instalada la aplicación en la máquina del usuario la clave será obtener la ruta en donde está la carpeta “Mis Imágenes”.  Esto es debido a que en la versión de Silverlight 4 Beta (la última versión al momento de crear este artículo) únicamente tendremos acceso a las carpetas del perfil del usuario (las carpetas Mi *) sin necesidad de las cajas de diálogo.  En vez de establecer la ruta de manera manual que potencialmente podría variar entre diferentes equipos y obviamente entre diferentes plataformas también es buena idea utilizar el enumerador SpecialFolder, quien nos regresará la ruta física según el valor seleccionado.  A continuación se muestra el código relacionado al evento Loaded de la aplicación en donde usamos el enumerador SpecialFolder en conjunto con el método GetFolderPath() de la clase Environment:

Es muy importante destacar la propiedad HasElevatedPermissions de la clase Application ya que esta propiedad nos indica ultimadamente si la aplicación está ejecutando en Confianza Elevada o no.  Por tal motivo será buena idea encerrar la ejecución de código en el bloque if{}.

Si bien las únicas carpetas a las que tenemos acceso sin necesidad de utilizar OpenFileDialog y SaveFileDialog son aquellas del perfil del usuario, a través de las cajas de diálogo podemos seguir teniendo acceso a cualquier carpeta que el usuario indique.  Incluso, en Confianza Elevada podemos obtener más información acerca de los archivos seleccionados a través de estas cajas de diálogo, por ejemplo, la ruta física completa del archivo en cuestión

El resultado de la aplicación es el siguiente:

Resumen

Las aplicaciones que ejecutan en Confianza Elevada tienen más funcionalidad, como por ejemplo el acceso al sistema de archivos de la máquina del usuario.

Sin usar las cajas de diálogo tradicionales OpenFileDialog y SaveFileDialog podemos acceder a las carpetas del perfil del usuario: Mis Imágenes, Mis Videos, Mi Música y Mis Documentos y potencialmente leer los archivos y su información relacionada.

Puedes descargar el código aquí

Puedes ver la demo en vivo aquí (requiere Silverlight 4 y ejecutar la aplicación Fuera del Navegador)

De manera predeterminada, las aplicaciones de Silverlight ejecutan en un ambiente conocido como un sandbox el cual permite que corran en confianza parcial.  Las aplicaciones que ejecutan en confianza parcial tienen acceso limitado a recursos y están limitadas en funcionalidad para evitar escenarios en donde el código desee hacer algo dañino al usuario.

Silverlight 4 incluye la posibilidad de ejecutar las aplicaciones en Confianza Elevada.  Cuando una aplicación ejecuta de esta manera se superan las limitantes del propio sandbox permitiendo que el aplicativo tenga acceso a recursos antes inaccesibles y a escenarios de funcionalidad casi como si se tratase de una aplicación de escritorio.

A continuación enlisto las posibilidades que se abren al crear este tipo de aplicaciones:

Acceso al Sistema de Archivos

Las aplicaciones que ejecutan en Confianza Elevada tienen acceso al Sistema de Archivos de la máquina del usuario sin necesidad de utilizar las cajas de diálogo OpenFileDialog y/o SaveFileDialog: los mecanismos clásicos utilizados para aplicaciones en confianza parcial.  No obstante, a la fecha de creación de este artículo las únicas carpetas a las que puede tener acceso en Confianza Elevada son las del perfil del usuario: Mis Documentos, Mis Imágenes, Mis Videos y Mi Música.

Mis Documentos, Mis Imágenes, Mis Videos y Mi Música son las únicas carpetas –por lo menos en Silverlight 4 Beta- a las que puede tener acceso una aplicación que ejecute en Confianza Elevada

Acceso ‘relajado’ a otros Dominios

De manera predeterminada, una aplicación que ejecuta en confianza parcial requiere uno de los archivos de política de seguridad (crossdomain.xml o clientaccesspolicy.xml) para poder acceder a un endpoint o recurso localizado en un dominio diferente al dominio en donde está la aplicación Silverlight.  Cuando se ejecuta en modo de Confianza Elevada este requerimiento es anulado, permitiendo que los aplicativos accedan a cualquier recurso en dominios externos.

Soporte completo al modo Pantalla Completa

Las aplicaciones que ejecutan en confianza parcial tienen acceso limitado al teclado cuando corren en Pantalla Completa, esto para evitar que una aplicación que simule la pantalla de credenciales del sistema operativo engañe al usuario.   Asimismo, en confianza parcial se muestra un mensaje indicando que la aplicación está corriendo en Pantalla Completa.  La siguiente figura muestra el mensaje que es mostrado al usuario:

Cuando una aplicación está configurada y corre en modo de Confianza Elevada el anterior mensaje es anulado y además la aplicación permite tener acceso completo al teclado.

Inicialización del Usuario ‘relajada’

Hay algunas características de la plataforma Silverlight que requieren ser invocadas por algún evento iniciado por el usuario: el clic de un botón del mouse o del teclado.  En modo de Confianza Elevada este requisito se suaviza permitiendo así que la característica en cuestión sea invocada desde eventos automáticos de la aplicación (el evento Load tal vez).  Un ejemplo claro es precisamente el punto anterior, el modo de Pantalla Completa que en confianza parcial exige que sea iniciado por algún evento del usuario.  Por otro lado, en Confianza Elevada el modo de Pantalla Completa podrá ser invocado desde cualquier evento de la aplicación.

Acceso a COM

En Confianza Elevada, las aplicaciones podrán invocar componentes COM para extender su funcionalidad.  Cabe mencionar que esta característica está presente únicamente para el sistema operativo Windows ya que en Mac OS no existe el concepto de COM.

Un punto en donde esta característica es especialmente útil es al integrar nuestras aplicaciones con Office, ya que podríamos desde Silverlight invocar vía COM las funcionalidades de cualquiera de sus productos.  En realidad, cualquier producto que exponga un componente de COM podría ser invocado desde nuestros aplicativos de Silverlight para complementar su funcionalidad.

Habilitando la Confianza Elevada

Ya que el modo de Confianza Elevada únicamente está presente para aplicaciones que ejecuten Afuera del Navegador, se ha agregado en la caja de diálogo de configuración de este tipo de aplicaciones la opción de ejecutar en Confianza Elevada:

Al habilitar esta opción, el manifiesto de la aplicación cambiará apropiadamente.  El siguiente fragmento de código muestra el archivo OutOfBrowserSettings.xml, archivo que será posteriormente incluido en el manifiesto presente en el archivo .xap:

Como podrán observar en el fragmento de código anterior, es el elemento <SecuritySettings> el cual indica si la aplicación ejecutará en Confianza Elevada o no.

Las aplicaciones Fuera del Navegador son las únicas que tienen la posibilidad de ejecutar en Confianza Elevada.  Las aplicaciones que corren adentro del navegador siempre ejecutarán en confianza parcial

Asimismo, la caja de diálogo de instalación de las aplicaciones cambia, advirtiendo al usuario que únicamente instale aplicaciones de sitios de confianza, ya que potencialmente este tipo de aplicativos puede dañar su equipo o hacer cosas maliciosas.

Resumen

En Silverlight 4 se agrega el modo de Confianza Elevada para que este tipo de aplicaciones superen las limitantes ya conocidas de la confianza parcial: modo predeterminado en el que ejecutan las aplicaciones de Silverlight.  Esto es especialmente interesante y emocionante para las personas que nos dedicamos a crear soluciones con esta plataforma ya que la línea de separación entre aplicaciones Web y de Escritorio cada vez es más delgada.

No obstante, si bien al habilitar esta opción se abre una puerta a mayores posibilidades de funcionalidad, también se abre otra: la de escenarios potencialmente maliciosos.  Pero aquí debemos ser muy claros: es y será la responsabilidad de cada usuario el decidir si instala o no en su equipo este tipo de aplicativos; sin embargo, es en este campo de cultura digital en donde falta mucho por hacer ya que independientemente de la plataforma tecnológica, es necesaria la educación en términos de seguridad y riesgo a toda persona que tenga contacto con un equipo de cómputo, para evitar a toda costa la propagación de aplicativos que tengan comportamientos contraproducentes, sobre todo a aquellas personas que no están directamente ligadas al ámbito tecnológico.

Un mundo de posibilidades está a nuestro alcance, aprovechémoslo con responsabilidad.

El proyecto

Crearemos un proyecto de Silverlight 4 por medio de Visual Studio 2010 Beta 2.  Al proyecto lo nombraremos Demo.SL4.Portapapeles y aceptaremos las opciones por default de creación del proyecto Web para probar la aplicación.  La aplicación tendrá la siguiente Interface de Usuario:

En el primer botón guardaremos el texto del TextBox en el Portapapeles.  Además, su propiedad IsEnabled estará atada a la ruta de propiedad Text.Length del TextBox.  Este es un buen ejemplo de Atado de Datos entre Elementos.  En el segundo botón leeremos el contenido del Portapapeles y lo pondremos en el TextBlock.

La aplicación estará configurada para poder correr en Confianza Elevada para mostrar los conceptos aquí demostrados.

Clase Clipboard

La clase que permite el acceso al Portapapeles es la clase System.Windows.Clipboard.  Es importante mencionar lo siguiente:

• El método ContainsText() indica si el Portapapeles tiene contenido
• Para aplicaciones que estén corriendo en el sandbox (aplicaciones dentro del Navegador o Aplicaciones Fuera del Navegador tradicionales), la ejecución de los métodos GetText() y SetText() provoca la siguiente caja de diálogo, para que el usuario dé permiso explícito a la aplicación para usar el Portapapeles.  Cabe mencionar que GetText() y SetText() en este caso deberán ser iniciadas por una acción del usuario (ejemplo: el Click de un botón):

• Para las aplicaciones que ejecuten en Confianza Elevada, la anterior caja de diálogo es omitida y tendremos acceso directo a los métodos de la clase.  Además los métodos podrán ser ejecutados desde cualquier evento.  Tal es el caso de nuestra aplicación de ejemplo en donde tenemos el siguiente código:

En el código podemos apreciar cómo estamos ejecutando el método SetText() siempre y cuando la aplicación esté corriendo en Confianza Elevada.

• El Portapapeles en Silverlight 4 (en esta versión Beta por lo menos), únicamente soporta cadenas de texto tipo Unicode.

Resultado

La aplicación ejecutando en Confianza Elevada:

Resumen

La clase System.Windows.Clipboard nos permite tener acceso programático al Portapapeles.  Si la aplicación está ejecutando en el sandbox (Confianza Parcial), el usuario tendrá que dar permiso explícito a través de una caja de diálogo para poder usar el Portapapeles.  Si la aplicación ejecuta en Confianza Elevada, esta caja de diálogo es omitida.

Pueden descargar el código de aquí

Pueden ver el demo en vivo aquí (requiere Silverlight 4)