Agregar un comando de shell a la barra de aplicaciones de la aplicación

En esta lección se muestra cómo agregar un comando a la barra de herramientas de la aplicación y cómo escribir el código que se ejecuta cuando se hace clic en el comando en tiempo de ejecución.El comando ejecuta una consulta parametrizada y muestra los resultados en una pantalla de búsqueda.

Agregar un comando Shell

En la lección anterior, agregue un comando que aparece en la barra de comandos de una pantalla.También puede programar un botón de la barra de herramientas para realizar otras tareas, por ejemplo, abrir otra pantalla, aplicar un filtro a los datos e incluso enviar un correo electrónico.

Cómo agregar una consulta parametrizada

  1. En el Explorador de soluciones, seleccione el nodo Clientes.

  2. En el menú Proyecto, haga clic en Agregar consulta.

  3. En la ventana Propiedades, en el campo Nombre, escriba CoincidenciaCliente.

  4. En el Diseñador de consultas, haga clic en Agregar filtro.

  5. En la segunda lista desplegable, seleccione NombreContacto.

  6. En la cuarta lista desplegable, seleccione Parámetro.

  7. En la última lista desplegable, haga clic en Agregar nuevo.

    Se agrega un nuevo parámetro denominado NombreContacto, de tipo String a la sección Parámetros del Editor de consultas.

Cómo agregar una pantalla de búsqueda

  1. En la barra de herramientas, haga clic en el botón Agregar pantalla.

  2. En el cuadro de diálogo Agregar nueva pantalla, seleccione Pantalla de búsqueda de datos en la lista Seleccione una plantilla de pantalla.

  3. En el campo Nombre de pantalla, escriba BuscarCliente.

  4. En la lista Datos de pantalla, seleccione – CoincidenciaCliente y, a continuación, haga clic en Aceptar.

  5. En el Diseñador de pantallas, seleccione el nodo NombreDeContactoDelCliente.

  6. En la ventana Propiedades, seleccione la propiedad Es parámetro.

Para agregar un comando a la barra de herramientas de la aplicación

  1. En el Explorador de soluciones, haga doble clic en ListadeContacto.

  2. En el Diseñador de pantallas, expanda el nodo Barra de comandos de pantalla.

  3. En la lista Agregar seleccione Nuevo botón.

    Aparecerá el cuadro de diálogo Agregar botón.

  4. En el cuadro de diálogo Agregar botón, seleccione Nuevo método y escriba Buscar en el cuadro Nombre y, a continuación, haga clic en Aceptar.

  5. En la ventana Propiedades, seleccione el campo Descripción y escriba Buscar el contacto seleccionado en la lista de clientes.

  6. Haga clic en el vínculo Elegir imagen.

  7. En el cuadro de diálogo Seleccionar imagen haga clic en Importar.

  8. En el cuadro de diálogo Abrir, navegue a un directorio con imágenes, seleccione una imagen y, a continuación, haga clic en Abrir.

  9. Haga clic en Aceptar para cerrar el cuadro de diálogo Seleccionar imagen.

  10. En el panel izquierdo, seleccione Buscar.

  11. En la ventana Propiedades, haga clic en Editar código de ejecución

    El Editor de código aparece y muestra el método Find_Execute().

  12. En el método Find_Execute(), agregue el siguiente código.

    Application.ShowSearchCustomer(Contacts.SelectedItem.ContactName)

    Application.ShowSearchCustomer(Contacts.SelectedItem.ContactName);

    Este código muestra la pantalla MostrarBúsquedaCliente cuando un usuario hace clic en el botón que se acaba de crear.

  13. Presione F5 para ejecutar la aplicación.

    Compruebe el nuevo comando seleccionando Howard Snyder en la lista Contactos y haciendo clic a continuación en el botón Buscar.

    Los resultados de la búsqueda

    La pantalla BúsquedaCliente debería aparecer y mostrar los datos para Great Lakes Food Market.Al hacer clic en Great Lakes Food Market en la columna Compañía, debería aparecer una pantalla Detalles del cliente.

Información detallada

En esta lección se ha mostrado cómo crear una consulta parametrizada que devuelve Clientes, que coincide con un parámetro NombreDeContacto, y cómo crear una pantalla de búsqueda basada en la consulta.Es posible que haya observado que la pantalla BúsquedaCliente no aparece en el menú de navegación de la aplicación en ejecución.Las pantallas a partir de consultas parametrizadas solo se pueden abrir ejecutando un comando y no se pueden agregar al menú.

En la lección luego se ha mostrado cómo agregar un comando a la pantalla ListaContacto, darle un Nombre para mostrar, Descripción e Imagen, y agregar código que se ejecuta cada vez que se hace clic en el botón de comando.El código ejecuta el método ShowSearchCustomer, que muestra la pantalla BúsquedaCliente.El código entre paréntesis es el parámetro al método, en este caso NombreContacto para el elemento seleccionado en la colección Contactos.

Es posible que haya observado que el comando únicamente aparece en la barra de herramientas de la aplicación cuando la pantalla ListaContacto está seleccionada.Dado que los comandos que se agregan a la barra de herramientas son específicos de la pantalla, debe crear un comando independiente para cada pantalla.

Pasos siguientes

En la siguiente lección, aprenderá cómo agregar un elemento en el menú de navegación.

Próxima lección: Personalización de elementos de menú

Vea también

Tareas

Cómo: Agregar un comando personalizado a una pantalla de Silverlight

Conceptos

Escribir código en LightSwitch

Otros recursos

Crear menús y comandos

  • Last updated on