MenuItemStyle Clase

Definición

Representa el estilo de un elemento de menú en un control Menu.Represents the style of a menu item in a Menu control. Esta clase no puede heredarse.This class cannot be inherited.

public ref class MenuItemStyle sealed : System::Web::UI::WebControls::Style
public sealed class MenuItemStyle : System.Web.UI.WebControls.Style
type MenuItemStyle = class
    inherit Style
Public NotInheritable Class MenuItemStyle
Inherits Style
Herencia

Ejemplos

En el ejemplo de código siguiente se muestra cómo controlar la apariencia de los elementos de menú en un Menu control estableciendo las propiedades de estilo del MenuItemStyle objeto devuelto por las DynamicMenuItemStyle DynamicHoverStyle propiedades,, StaticMenuItemStyle y StaticHoverStyle .The following code example demonstrates how to control the appearance of the menu items in a Menu control by setting the style properties of the MenuItemStyle object returned from the DynamicMenuItemStyle, DynamicHoverStyle, StaticMenuItemStyle, and StaticHoverStyle properties.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >

  <!-- For the hover styles of the Menu control to  -->
  <!-- work correctly, you must include this head   -->
  <!-- element.                                     -->
  <head runat="server">
    <title>MenuItemStyle Example</title>
</head>

  <body>
    <form id="form1" runat="server">
    
      <h3>MenuItemStyle Example</h3>
    
      <!-- Set the style properties of the        -->
      <!-- MenuItemStyle objects contained in the -->
      <!-- StaticMenuItemStyle, StaticHoverStyle, -->
      <!-- DynamicMenuItemStyle, and              -->
      <!-- DynamicHoverStyle properties.          -->
      
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        runat="server">
        
        <staticmenuitemstyle backcolor="LightSteelBlue"
          horizontalpadding="5"
          verticalpadding="2"
          font-names="Arial"   
          forecolor="Black"/>
        <statichoverstyle backcolor="LightSkyBlue"
          font-names="Arial"
          forecolor="Red"/>
        <dynamicmenuitemstyle backcolor="Black"
          horizontalpadding="10"
          verticalpadding="4"
          itemspacing="2"
          font-names="Arial"
          forecolor="Silver"/>
        <dynamichoverstyle backcolor="LightSkyBlue"
          font-names="Arial"
          forecolor="Red"/>
      
        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Music"
              tooltip="Music">
              <asp:menuitem text="Classical"
                tooltip="Classical"/>
              <asp:menuitem text="Rock"
                tooltip="Rock"/>
              <asp:menuitem text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem text="Movies"
              tooltip="Movies">
              <asp:menuitem text="Action"
                tooltip="Action"/>
              <asp:menuitem text="Drama"
                tooltip="Drama"/>
              <asp:menuitem text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

    </form>
  </body>
</html>


<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >

  <!-- For the hover styles of the Menu control to  -->
  <!-- work correctly, you must include this head   -->
  <!-- element.                                     -->
  <head runat="server">
    <title>MenuItemStyle Example</title>
</head>

  <body>
    <form id="form1" runat="server">
    
      <h3>MenuItemStyle Example</h3>
    
      <!-- Set the style properties of the        -->
      <!-- MenuItemStyle objects contained in the -->
      <!-- StaticMenuItemStyle, StaticHoverStyle, -->
      <!-- DynamicMenuItemStyle, and              -->
      <!-- DynamicHoverStyle properties.          -->
      
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        runat="server">
        
        <staticmenuitemstyle backcolor="LightSteelBlue"
          horizontalpadding="5"
          verticalpadding="2"
          font-names="Arial"   
          forecolor="Black"/>
        <statichoverstyle backcolor="LightSkyBlue"
          font-names="Arial"
          forecolor="Red"/>
        <dynamicmenuitemstyle backcolor="Black"
          horizontalpadding="10"
          verticalpadding="4"
          itemspacing="2"
          font-names="Arial"
          forecolor="Silver"/>
        <dynamichoverstyle backcolor="LightSkyBlue"
          font-names="Arial"
          forecolor="Red"/>
      
        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Music"
              tooltip="Music">
              <asp:menuitem text="Classical"
                tooltip="Classical"/>
              <asp:menuitem text="Rock"
                tooltip="Rock"/>
              <asp:menuitem text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem text="Movies"
              tooltip="Movies">
              <asp:menuitem text="Action"
                tooltip="Action"/>
              <asp:menuitem text="Drama"
                tooltip="Drama"/>
              <asp:menuitem text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

    </form>
  </body>
</html>

Comentarios

Use la MenuItemStyle clase para representar el estilo de un elemento de menú en el Menu control.Use the MenuItemStyle class to represent the style of a menu item in the Menu control. Un elemento de menú se muestra en un menú estático o en un menú dinámico.A menu item is displayed in either a static menu or a dynamic menu. Un menú estático siempre se muestra en un Menu control, mientras que un menú dinámico solo se muestra cuando el usuario coloca el puntero del mouse sobre un elemento de menú primario que contiene un submenú dinámico.A static menu is always displayed in a Menu control, whereas a dynamic menu is displayed only when the user positions the mouse pointer over a parent menu item that contains a dynamic submenu. Puede especificar diferentes características de estilo (como el tamaño y el color de la fuente) para cada uno de los distintos tipos de elemento de menú.You can specify different style characteristics (such as font size and color) for each of the different menu item types. En la tabla siguiente se enumeran los estilos de elemento de menú disponibles.The following table lists the available menu item styles.

Propiedad de estilo de elemento de menúMenu item style property DescripciónDescription
DynamicHoverStyle Configuración de estilo de un elemento de menú dinámico cuando el puntero del mouse se coloca sobre él.The style settings for a dynamic menu item when the mouse pointer is positioned over it.
DynamicMenuItemStyle La configuración de estilo para un elemento de menú dinámico individual.The style settings for an individual dynamic menu item.
DynamicMenuStyle La configuración de estilo de un menú dinámico.The style settings for a dynamic menu.
DynamicSelectedStyle La configuración de estilo para el elemento de menú dinámico seleccionado actualmente.The style settings for the currently selected dynamic menu item.
StaticHoverStyle Configuración de estilo de un elemento de menú estático cuando el puntero del mouse se coloca sobre él.The style settings for a static menu item when the mouse pointer is positioned over it.
StaticMenuItemStyle La configuración de estilo para un elemento de menú estático individual.The style settings for an individual static menu item.
StaticMenuStyle La configuración de estilo de un menú estático.The style settings for a static menu.
StaticSelectedStyle La configuración de estilo para el elemento de menú estático seleccionado actualmente.The style settings for the currently selected static menu item.

Cuando se establecen varias propiedades de estilo para un elemento de menú estático, las propiedades de estilo se aplican en el orden siguiente:When multiple style properties are set for a static menu item, the style properties are applied in the following order:

  1. StaticMenuStyle.StaticMenuStyle.

  2. StaticMenuItemStyle.StaticMenuItemStyle. Si LevelMenuItemStyles se define la colección o la LevelSubMenuStyles colección, se aplica en este momento, invalidando las demás propiedades de estilo del elemento de menú.If the LevelMenuItemStyles collection or LevelSubMenuStyles collection is defined, it is applied at this time, overriding the other menu item style properties.

  3. StaticSelectedStyle.StaticSelectedStyle. Si LevelSelectedStyles se define la colección, se aplica en este momento, invalidando las demás propiedades de estilo del elemento de menú.If the LevelSelectedStyles collection is defined, it is applied at this time, overriding the other menu item style properties.

  4. StaticHoverStyle.StaticHoverStyle.

Del mismo modo, las propiedades de estilo de un elemento de menú dinámico se aplican en el orden siguiente:Likewise, the style properties for a dynamic menu item are applied in the following order:

  1. DynamicMenuStyle.DynamicMenuStyle.

  2. DynamicMenuItemStyle.DynamicMenuItemStyle. Si LevelMenuItemStyles se define la colección o la LevelSubMenuStyles colección, se aplica en este momento, invalidando las demás propiedades de estilo del elemento de menú.If the LevelMenuItemStyles collection or LevelSubMenuStyles collection is defined, it is applied at this time, overriding the other menu item style properties.

  3. DynamicSelectedStyle.DynamicSelectedStyle. Si LevelSelectedStyles se define la colección, se aplica en este momento, invalidando las demás propiedades de estilo del elemento de menú.If the LevelSelectedStyles collection is defined, it is applied at this time, overriding the other menu item style properties.

  4. DynamicHoverStyle.DynamicHoverStyle.

La MenuItemStyle clase hereda la mayoría de sus miembros de la Style clase.The MenuItemStyle class inherits most of its members from the Style class. Extiende la Style clase proporcionando propiedades que controlan la cantidad de espacio alrededor del texto de un elemento de menú, así como el espacio entre los elementos de menú adyacentes.It extends the Style class by providing properties that control the amount of space around a menu item's text, as well as the space between adjacent menu items. Utilice la HorizontalPadding propiedad para controlar la cantidad de espacio a la izquierda y a la derecha del texto del elemento de menú.Use the HorizontalPadding property to control the amount of space to the left and right of the menu item's text. Del mismo modo, la VerticalPadding propiedad controla la cantidad de espacio por encima y debajo del texto del elemento de menú.Similarly, the VerticalPadding property controls the amount of space above and below the menu item's text. Puede controlar la cantidad de espacio entre el elemento de menú MenuItemStyle al que se aplica el objeto y sus elementos de menú adyacentes estableciendo la ItemSpacing propiedad.You can control the amount of spacing between the menu item that the MenuItemStyle object is applied to and its adjacent menu items by setting the ItemSpacing property.

Para obtener más información sobre la configuración de estilo heredada, vea Style .For more information on the inherited style settings, see Style.

Constructores

MenuItemStyle()

Inicializa una nueva instancia de la clase MenuItemStyle.Initializes a new instance of the MenuItemStyle class.

MenuItemStyle(StateBag)

Inicializa una nueva instancia de la clase MenuItemStyle utilizando la información de estado especificada.Initializes a new instance of the MenuItemStyle class using the specified state information.

Propiedades

BackColor

Obtiene o establece el color de fondo del control de servidor web.Gets or sets the background color of the Web server control.

(Heredado de Style)
BorderColor

Obtiene o establece el color del borde del control de servidor Web.Gets or sets the border color of the Web server control.

(Heredado de Style)
BorderStyle

Obtiene o establece el estilo del borde del control de servidor web.Gets or sets the border style of the Web server control.

(Heredado de Style)
BorderWidth

Obtiene o establece el ancho del borde del control de servidor web.Gets or sets the border width of the Web server control.

(Heredado de Style)
CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.Gets a value indicating whether the component can raise an event.

(Heredado de Component)
Container

Obtiene la interfaz IContainer que contiene la clase Component.Gets the IContainer that contains the Component.

(Heredado de Component)
CssClass

Obtiene o establece la clase de hoja de estilos en cascada (CSS) representada por el control de servidor Web en el cliente.Gets or sets the cascading style sheet (CSS) class rendered by the Web server control on the client.

(Heredado de Style)
DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.Gets a value that indicates whether the Component is currently in design mode.

(Heredado de Component)
Events

Obtiene la lista de controladores de eventos asociados a Component.Gets the list of event handlers that are attached to this Component.

(Heredado de Component)
Font

Obtiene las propiedades de fuente asociadas al control de servidor web.Gets the font properties associated with the Web server control.

(Heredado de Style)
ForeColor

Obtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Heredado de Style)
Height

Obtiene o establece el alto del control de servidor Web.Gets or sets the height of the Web server control.

(Heredado de Style)
HorizontalPadding

Obtiene o establece la cantidad de espacio a la izquierda y derecha del texto del elemento de menú.Gets or sets the amount of space to the left and right of the menu item's text.

IsEmpty

Propiedad protegida.A protected property. Obtiene un valor que indica si se han definido elementos de estilo en la bolsa de estados.Gets a value indicating whether any style elements have been defined in the state bag.

(Heredado de Style)
IsTrackingViewState

Devuelve un valor que indica si se han definido elementos de estilo en la bolsa de estados.Returns a value indicating whether any style elements have been defined in the state bag.

(Heredado de Style)
ItemSpacing

Obtiene o establece la cantidad de espaciado vertical entre el elemento de menú al que se aplica el objeto MenuItemStyle y sus elementos de menú adyacentes.Gets or sets the amount of vertical spacing between the menu item to which the MenuItemStyle object is applied and its adjacent menu items.

RegisteredCssClass

Obtiene la clase de hoja de estilos en cascada (CSS) que se registra con el control.Gets the cascading style sheet (CSS) class that is registered with the control.

(Heredado de Style)
Site

Obtiene o establece ISite de Component.Gets or sets the ISite of the Component.

(Heredado de Component)
VerticalPadding

Obtiene o establece la cantidad de espacio por encima y debajo del texto de un elemento de menú.Gets or sets the amount of space above and below a menu item's text.

ViewState

Obtiene la bolsa de estados que contiene los elementos de estilo.Gets the state bag that holds the style elements.

(Heredado de Style)
Width

Obtiene o establece el ancho del control de servidor web.Gets or sets the width of the Web server control.

(Heredado de Style)

Métodos

AddAttributesToRender(HtmlTextWriter)

Agrega atributos y estilos HTML que se deben representar en el HtmlTextWriter especificado.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter. Este método lo usan principalmente los programadores de controles.This method is primarily used by control developers.

(Heredado de Style)
AddAttributesToRender(HtmlTextWriter, WebControl)

Agrega al objeto HtmlTextWriter y al control de servidor Web especificados los atributos y estilos HTML que se deben representar.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter and Web server control. Este método lo usan principalmente los programadores de controles.This method is primarily used by control developers.

(Heredado de Style)
CopyFrom(Style)

Copia las propiedades de estilo del objeto Style especificado en la instancia actual de la clase MenuItemStyle.Copies the style properties of the specified Style object into the current instance of the MenuItemStyle class.

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos que usa Component.Releases all resources used by the Component.

(Heredado de Component)
Dispose(Boolean)

Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Heredado de Component)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
FillStyleAttributes(CssStyleCollection, IUrlResolutionService)

Agrega las propiedades de estilo del objeto especificado a un objeto CssStyleCollection.Adds the specified object's style properties to a CssStyleCollection object.

(Heredado de Style)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLifetimeService()
Obsoleto.

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.Returns an object that represents a service provided by the Component or by its Container.

(Heredado de Component)
GetStyleAttributes(IUrlResolutionService)

Recupera el objeto CssStyleCollection para el objeto implementado por IUrlResolutionService especificado.Retrieves the CssStyleCollection object for the specified IUrlResolutionService-implemented object.

(Heredado de Style)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeLifetimeService()
Obsoleto.

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
LoadViewState(Object)

Carga el estado previamente guardado.Loads the previously saved state.

(Heredado de Style)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
MergeWith(Style)

Combina las propiedades de estilo del objeto Style especificado con las de la instancia actual de la clase MenuItemStyle.Combines the style properties of the specified Style object with those of the current instance of the MenuItemStyle class.

Reset()

Devuelve la instancia actual de la clase MenuItemStyle a su estado original.Returns the current instance of the MenuItemStyle class to its original state.

SaveViewState()

Método protegido.A protected method. Guarda cualquier estado que se haya modificado después de que se invocara al método TrackViewState().Saves any state that has been modified after the TrackViewState() method was invoked.

(Heredado de Style)
SetBit(Int32)

Método interno protegido.A protected internal method. Establece un campo de máscara de bits interno que indica las propiedades de estilo almacenadas en la bolsa de estados.Sets an internal bitmask field that indicates the style properties that are stored in the state bag.

(Heredado de Style)
SetDirty()

Marca Style para que su estado se registre en el estado de vista.Marks the Style so that its state will be recorded in view state.

(Heredado de Style)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Style)
TrackViewState()

Método protegido.A protected method. Marca el comienzo del seguimiento de los cambios de estado en el control.Marks the beginning for tracking state changes on the control. Los cambios realizados una vez iniciado el seguimiento serán objeto de seguimiento y se guardarán como parte del estado de vista del control.Any changes made after tracking has begun will be tracked and saved as part of the control view state.

(Heredado de Style)

Eventos

Disposed

Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Heredado de Component)

Implementaciones de interfaz explícitas

IStateManager.IsTrackingViewState

Obtiene un valor que indica si un control de servidor está realizando el seguimiento de los cambios en su estado de vista.Gets a value that indicates whether a server control is tracking its view state changes.

(Heredado de Style)
IStateManager.LoadViewState(Object)

Carga el estado previamente guardado.Loads the previously saved state.

(Heredado de Style)
IStateManager.SaveViewState()

Devuelve el objeto que contiene los cambios de estado.Returns the object containing state changes.

(Heredado de Style)
IStateManager.TrackViewState()

Inicia el seguimiento de los cambios de estado.Starts tracking state changes.

(Heredado de Style)

Se aplica a

Consulte también