Menu (Clase)

Un control Menu se compone de un árbol de elementos de menú representados por objetos MenuItem. Los elementos de menú del nivel superior (nivel 0) se denominan elementos del menú raíz. Un elemento de menú que tiene un elemento de menú primario se llama elemento de menú secundario. Todos los elementos del menú raíz se almacenan en la colección Items. Los elementos de un menú secundario se almacenan en la colección ChildItems de elementos de su menú primario.

Cada elemento de menú tiene una propiedad Text y una propiedad Value. El valor de la propiedad Text se muestra en el control Menu, mientras que la propiedad Value se utiliza para almacenar cualquier información adicional sobre el elemento de menú, tal como los datos que se pasan al evento de devolución de datos asociado al elemento de menú. Al hacer clic en un elemento de menú, éste puede llevar al usuario a otra página Web indicada por la propiedad NavigateUrl.

Nota:
Al hacer clic sobre un elemento de menú cuya propiedad NavigateUrl no se ha establecido, el control Menu simplemente envía la página al servidor para que la procese.

Opcionalmente, también es posible mostrar una imagen en un elemento de menú estableciendo la propiedad ImageUrl.

Para obtener más información sobre elementos de menú, vea MenuItem.

El modelo de datos más simple del control Menu es el de los elementos de menú estáticos. Para mostrar elementos de menú estáticos mediante sintaxis declarativa, primero coloque etiquetas <Items> de apertura y cierre entre las etiquetas de apertura y cierre del control Menu. A continuación, cree la estructura de menú anidando los elementos <asp:MenuItem> entre las etiquetas <Items> de apertura y cierre. Cada elemento <asp:MenuItem> representa un elemento de menú del control y se corresponde con un objeto MenuItem. Puede establecer las propiedades de cada elemento de menú estableciendo los atributos de su elemento <asp:MenuItem>. Para crear los elementos de submenú, anide elementos <asp:MenuItem> adicionales entre las etiquetas <asp:MenuItem> de apertura y cierre del elemento de menú primario.

El control Menu también se puede enlazar a datos. Para enlazar el control Menu al tipo de origen de datos adecuado, puede utilizar uno cualquiera de los dos métodos siguientes:

• El control Menu puede utilizar cualquier control de origen de datos jerárquico, como un control XmlDataSource o un control SiteMapDataSource. Para enlazar a un control de origen de datos jerárquico, establezca la propiedad DataSourceID del control Menu en el valor ID del control de origen de datos. El control Menu se enlaza automáticamente al control de origen de datos especificado. Éste es el método recomendado para el enlace a datos.

• El control Menu también se puede enlazar a un objeto XmlDocument. Para enlazar el control a este origen de datos, establezca la propiedad DataSource del control Menu en el origen de datos y, a continuación, llame al método DataBind.

Al enlazar a un origen de datos donde cada elemento de datos contiene varias propiedades (como un elemento XML con varios atributos), un elemento de menú muestra de manera predeterminada el valor devuelto por el método ToString del elemento de datos. En el caso de un elemento XML, el elemento de menú muestra el nombre del elemento, el cual indica la estructura subyacente del árbol de menús, pero no es muy útil en otro sentido. Un elemento de menú se puede enlazar a una propiedad específica del elemento de datos mediante la colección DataBindings, la cual permite especificar los enlaces del elemento de menú. La colección DataBindings contiene objetos MenuItemBinding que definen la relación entre un elemento de datos y el elemento de menú al que se enlaza. Puede especificar los criterios del enlace y la propiedad del elemento de datos que se va a mostrar en el nodo. Para obtener más información sobre enlaces de elementos de menú, vea MenuItemBinding.

No puede crear nodos vacíos en un control Menu estableciendo las propiedades Text o TextField en la cadena vacía (""). Establecer estas propiedades en la cadena vacía produce el mismo efecto que no establecer las propiedades. En ese caso, el control Menu crea un enlace predeterminado utilizando la propiedad DataSource. Para obtener más información, vea Técnicas de enlace de datos en páginas Web.

Existen muchas maneras de personalizar el aspecto del control Menu. En primer lugar, puede especificar si el control Menu se va a representar horizontal o verticalmente estableciendo la propiedad Orientation. También puede especificar un estilo diferente (por ejemplo, tamaño y color de fuente) para cada uno de los tipos de elemento de menú.

Si utiliza hojas de estilos en cascada (CSS) para personalizar la apariencia del control, utilice estilos en línea o un archivo CSS independiente, pero no ambos. Si se utilizan ambos, se podrían producir resultados inesperados. Para obtener más información sobre cómo utilizar hojas de estilos con controles, vea Controles de servidor Web ASP.NET y estilos de CSS.

La tabla siguiente enumera los estilos de elementos de menú disponibles.

En lugar de establecer las propiedades de estilo individuales, puede especificar estilos que se aplican a los elementos de menú según su nivel utilizando las colecciones de estilos siguientes.

El primer estilo de la colección corresponde al estilo de los elementos de menú del primer nivel de profundidad del árbol de menús. El segundo estilo de la colección corresponde al estilo de los elementos de menú del segundo nivel de profundidad del árbol de menús, y así sucesivamente. Esto se suele utilizar frecuentemente para generar menús de exploración similares a tablas de contenido, donde los elementos de menú de una cierta profundidad deberían tener todos el mismo aspecto, independientemente de si tienen o no submenús.

Nota:
Si utiliza cualquiera de las colecciones de estilos para niveles mostradas en la tabla anterior para definir el estilo del control Menu, estos valores de configuración de estilo reemplazan las propiedades de estilo de los elementos de menú individuales.

Otra manera de modificar la apariencia del control es la personalización de las imágenes que se muestran en el control Menu. Puede especificar su propia imagen personalizada para las diferentes partes del control estableciendo las propiedades que aparecen en la tabla siguiente.

Para conseguir un control completo de la interfaz de usuario, puede definir sus propias plantillas personalizadas para el control Menu utilizando las propiedades de plantilla siguientes.

Puede controlar la posición vertical y horizontal de un menú dinámico con respecto a su elemento de menú primario estableciendo las propiedades DynamicVerticalOffset y DynamicHorizontalOffset, respectivamente. Para controlar la sangría de los elementos de submenú estáticos dentro de un menú estático, utilice la propiedad StaticSubMenuIndent.

El control Menu proporciona varios eventos que puede utilizar para programar. De esta manera, se puede ejecutar una rutina personalizada siempre que se produzca un evento. En la siguiente tabla se enumeran los eventos admitidos.

Es posible que el marcado que se representa de manera predeterminada para este control no respete los estándares de accesibilidad enunciados en las directrices prioritarias de WCAG (Instrucciones de accesibilidad a contenido Web 1.0). Para obtener detalles sobre accesibilidad compatible con este control, vea Controles y accesibilidad en ASP.NET.

El control Menu proporciona la propiedad SkipLinkText como una manera de que los lectores de pantalla omitan todo el control. Si se establece la propiedad SkipLinkText, se representa una imagen invisible con texto alternativo, lo que ofrece al usuario la opción de saltar al final del control. El lector de pantalla lee el texto alternativo en voz alta, mientras que la imagen ocupa sólo un píxel de espacio. Para un control preciso de los píxeles en la representación de la página, establezca la propiedad SkipLinkText en una cadena vacía ("") y proporcione un mecanismo propio para omitir el menú. De manera predeterminada, la propiedad SkipLinkText se establece en una cadena vacía.