MenuItemStyle Classe
Definição
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
- Herança
Exemplos
O exemplo de código a seguir demonstra como controlar a aparência dos itens de menu em um Menu controle definindo as propriedades de estilo do MenuItemStyle objeto retornado das DynamicMenuItemStyle Propriedades, DynamicHoverStyle , e StaticMenuItemStyle 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>
Comentários
Use a MenuItemStyle classe para representar o estilo de um item de menu no Menu controle.Use the MenuItemStyle class to represent the style of a menu item in the Menu control. Um item de menu é exibido em um menu estático ou dinâmico.A menu item is displayed in either a static menu or a dynamic menu. Um menu estático é sempre exibido em um Menu controle, enquanto um menu dinâmico é exibido somente quando o usuário posiciona o ponteiro do mouse sobre um item de menu pai que contém um submenu 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. Você pode especificar características de estilo diferentes (como tamanho e cor da fonte) para cada um dos diferentes tipos de item de menu.You can specify different style characteristics (such as font size and color) for each of the different menu item types. A tabela a seguir lista os estilos de item de menu disponíveis.The following table lists the available menu item styles.
| Propriedade de estilo do item de menuMenu item style property | DescriçãoDescription |
|---|---|
| DynamicHoverStyle | As configurações de estilo de um item de menu dinâmico quando o ponteiro do mouse está posicionado sobre ele.The style settings for a dynamic menu item when the mouse pointer is positioned over it. |
| DynamicMenuItemStyle | As configurações de estilo de um item de menu dinâmico individual.The style settings for an individual dynamic menu item. |
| DynamicMenuStyle | As configurações de estilo de um menu dinâmico.The style settings for a dynamic menu. |
| DynamicSelectedStyle | As configurações de estilo do item de menu dinâmico selecionado no momento.The style settings for the currently selected dynamic menu item. |
| StaticHoverStyle | As configurações de estilo de um item de menu estático quando o ponteiro do mouse está posicionado sobre ele.The style settings for a static menu item when the mouse pointer is positioned over it. |
| StaticMenuItemStyle | As configurações de estilo de um item de menu estático individual.The style settings for an individual static menu item. |
| StaticMenuStyle | As configurações de estilo de um menu estático.The style settings for a static menu. |
| StaticSelectedStyle | As configurações de estilo do item de menu estático selecionado atualmente.The style settings for the currently selected static menu item. |
Quando várias propriedades de estilo são definidas para um item de menu estático, as propriedades de estilo são aplicadas na seguinte ordem:When multiple style properties are set for a static menu item, the style properties are applied in the following order:
StaticMenuItemStyle.StaticMenuItemStyle. Se a LevelMenuItemStyles coleção ou LevelSubMenuStyles coleção for definida, ela será aplicada neste momento, substituindo as outras propriedades de estilo do item de menu.If the LevelMenuItemStyles collection or LevelSubMenuStyles collection is defined, it is applied at this time, overriding the other menu item style properties.
StaticSelectedStyle.StaticSelectedStyle. Se a LevelSelectedStyles coleção for definida, ela será aplicada neste momento, substituindo as outras propriedades de estilo do item de menu.If the LevelSelectedStyles collection is defined, it is applied at this time, overriding the other menu item style properties.
Da mesma forma, as propriedades de estilo de um item de menu dinâmico são aplicadas na seguinte ordem:Likewise, the style properties for a dynamic menu item are applied in the following order:
DynamicMenuItemStyle.DynamicMenuItemStyle. Se a LevelMenuItemStyles coleção ou LevelSubMenuStyles coleção for definida, ela será aplicada neste momento, substituindo as outras propriedades de estilo do item de menu.If the LevelMenuItemStyles collection or LevelSubMenuStyles collection is defined, it is applied at this time, overriding the other menu item style properties.
DynamicSelectedStyle.DynamicSelectedStyle. Se a LevelSelectedStyles coleção for definida, ela será aplicada neste momento, substituindo as outras propriedades de estilo do item de menu.If the LevelSelectedStyles collection is defined, it is applied at this time, overriding the other menu item style properties.
A MenuItemStyle classe herda a maioria de seus membros da Style classe.The MenuItemStyle class inherits most of its members from the Style class. Ele estende a Style classe fornecendo propriedades que controlam a quantidade de espaço em relação ao texto de um item de menu, bem como o espaço entre os itens de menu adjacentes.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. Use a HorizontalPadding propriedade para controlar a quantidade de espaço à esquerda e à direita do texto do item de menu.Use the HorizontalPadding property to control the amount of space to the left and right of the menu item's text. Da mesma forma, a VerticalPadding propriedade controla a quantidade de espaço acima e abaixo do texto do item de menu.Similarly, the VerticalPadding property controls the amount of space above and below the menu item's text. Você pode controlar a quantidade de espaçamento entre o item de menu MenuItemStyle ao qual o objeto é aplicado e seus itens de menu adjacentes definindo a ItemSpacing propriedade.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 obter mais informações sobre as configurações de estilo herdadas, consulte Style .For more information on the inherited style settings, see Style.
Construtores
| MenuItemStyle() |
Inicializa uma nova instância da classe MenuItemStyle.Initializes a new instance of the MenuItemStyle class. |
| MenuItemStyle(StateBag) |
Inicializa uma nova instância da classe MenuItemStyle usando as informações de estado especificadas.Initializes a new instance of the MenuItemStyle class using the specified state information. |
Propriedades
| BackColor |
Obtém ou define a cor da tela de fundo do controle do servidor Web.Gets or sets the background color of the Web server control. (Herdado de Style) |
| BorderColor |
Obtém ou define a cor de borda do controle de servidor Web.Gets or sets the border color of the Web server control. (Herdado de Style) |
| BorderStyle |
Obtém ou define o estilo de borda do controle de servidor Web.Gets or sets the border style of the Web server control. (Herdado de Style) |
| BorderWidth |
Obtém ou define a largura da borda do controle de servidor Web.Gets or sets the border width of the Web server control. (Herdado de Style) |
| CanRaiseEvents |
Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event. (Herdado de Component) |
| Container |
Obtém o IContainer que contém o Component.Gets the IContainer that contains the Component. (Herdado de Component) |
| CssClass |
Obtém ou define a classe CSS (folha de estilos em cascata) renderizada pelo controle do servidor Web no cliente.Gets or sets the cascading style sheet (CSS) class rendered by the Web server control on the client. (Herdado de Style) |
| DesignMode |
Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode. (Herdado de Component) |
| Events |
Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this Component. (Herdado de Component) |
| Font |
Obtém as propriedades de fonte associadas ao controle do servidor Web.Gets the font properties associated with the Web server control. (Herdado de Style) |
| ForeColor |
Obtém ou define a cor de primeiro plano (normalmente a cor do texto) do controle de servidor Web.Gets or sets the foreground color (typically the color of the text) of the Web server control. (Herdado de Style) |
| Height |
Obtém ou define a altura do controle do servidor Web.Gets or sets the height of the Web server control. (Herdado de Style) |
| HorizontalPadding |
Obtém ou define a quantidade de espaço à esquerda e à direita do texto do item de menu.Gets or sets the amount of space to the left and right of the menu item's text. |
| IsEmpty |
Uma propriedade protegida.A protected property. Obtém um valor que indica se algum elemento de estilo foi definido no recipiente de estados.Gets a value indicating whether any style elements have been defined in the state bag. (Herdado de Style) |
| IsTrackingViewState |
Retorna um valor que indica se algum elemento de estilo foi definido no recipiente de estados.Returns a value indicating whether any style elements have been defined in the state bag. (Herdado de Style) |
| ItemSpacing |
Obtém ou define a quantidade de espaçamento vertical entre o item de menu ao qual o objeto MenuItemStyle será aplicado e seus itens de menu adjacentes.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 |
Obtém a classe CSS (folha de estilos em cascata) que está registrada com o controle.Gets the cascading style sheet (CSS) class that is registered with the control. (Herdado de Style) |
| Site |
Obtém ou define o ISite do Component.Gets or sets the ISite of the Component. (Herdado de Component) |
| VerticalPadding |
Obtém ou define a quantidade de espaço acima e abaixo do texto de um item de menu.Gets or sets the amount of space above and below a menu item's text. |
| ViewState |
Obtém o recipiente de estados que contém os elementos de estilo.Gets the state bag that holds the style elements. (Herdado de Style) |
| Width |
Obtém ou define a largura do controle de servidor Web.Gets or sets the width of the Web server control. (Herdado de Style) |
Métodos
| AddAttributesToRender(HtmlTextWriter) |
Adiciona atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriter especificado.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter. Esse método é usado principalmente por desenvolvedores de controles.This method is primarily used by control developers. (Herdado de Style) |
| AddAttributesToRender(HtmlTextWriter, WebControl) |
Adiciona atributos HTML e estilos que precisam ser renderizados ao controle de servidor Web HtmlTextWriter especificado.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter and Web server control. Esse método é usado principalmente por desenvolvedores de controles.This method is primarily used by control developers. (Herdado de Style) |
| CopyFrom(Style) |
Copia as propriedades de estilo do objeto Style especificado para a instância atual da classe MenuItemStyle.Copies the style properties of the specified Style object into the current instance of the MenuItemStyle class. |
| CreateObjRef(Type) |
Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Herdado de MarshalByRefObject) |
| Dispose() |
Libera todos os recursos usados pelo Component.Releases all resources used by the Component. (Herdado de Component) |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the Component and optionally releases the managed resources. (Herdado de Component) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object. (Herdado de Object) |
| FillStyleAttributes(CssStyleCollection, IUrlResolutionService) |
Adiciona as propriedades de estilo do objeto especificado a um objeto CssStyleCollection.Adds the specified object's style properties to a CssStyleCollection object. (Herdado de Style) |
| GetHashCode() |
Serve como a função de hash padrão.Serves as the default hash function. (Herdado de Object) |
| GetLifetimeService() |
Obsoleto.
Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Herdado de MarshalByRefObject) |
| GetService(Type) |
Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container. (Herdado de Component) |
| GetStyleAttributes(IUrlResolutionService) |
Recupera o objeto CssStyleCollection especificado objeto implementado por IUrlResolutionService.Retrieves the CssStyleCollection object for the specified IUrlResolutionService-implemented object. (Herdado de Style) |
| GetType() |
Obtém o Type da instância atual.Gets the Type of the current instance. (Herdado de Object) |
| InitializeLifetimeService() |
Obsoleto.
Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance. (Herdado de MarshalByRefObject) |
| LoadViewState(Object) |
Carrega o estado salvo anteriormente.Loads the previously saved state. (Herdado de Style) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object. (Herdado de MarshalByRefObject) |
| MergeWith(Style) |
Copia as propriedades de estilo do objeto Style especificado com aquelas da instância atual da classe MenuItemStyle.Combines the style properties of the specified Style object with those of the current instance of the MenuItemStyle class. |
| Reset() |
Retorna a instância atual da classe MenuItemStyle ao seu estado original.Returns the current instance of the MenuItemStyle class to its original state. |
| SaveViewState() |
Um método protegido.A protected method. Salva qualquer estado que tenha sido modificado depois que o método TrackViewState() foi invocado.Saves any state that has been modified after the TrackViewState() method was invoked. (Herdado de Style) |
| SetBit(Int32) |
Um método interno protegido.A protected internal method. Define um campo interno de máscara de bits que indica as propriedades de estilo que estão armazenadas no recipiente de estados.Sets an internal bitmask field that indicates the style properties that are stored in the state bag. (Herdado de Style) |
| SetDirty() |
Marca o Style de maneira que seu estado seja registrado na exibição de estado.Marks the Style so that its state will be recorded in view state. (Herdado de Style) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object. (Herdado de Style) |
| TrackViewState() |
Um método protegido.A protected method. Marca o início para controlar alterações de estado no controle.Marks the beginning for tracking state changes on the control. Todas as alterações feitas após o início do acompanhamento serão acompanhadas e salvas como parte do estado de exibição do controle.Any changes made after tracking has begun will be tracked and saved as part of the control view state. (Herdado de Style) |
Eventos
| Disposed |
Ocorre quando o componente é disposto por uma chamada ao método Dispose().Occurs when the component is disposed by a call to the Dispose() method. (Herdado de Component) |
Implantações explícitas de interface
| IStateManager.IsTrackingViewState |
Obtém um valor que indica se um controle de servidor está acompanhando as alterações de estado de exibição.Gets a value that indicates whether a server control is tracking its view state changes. (Herdado de Style) |
| IStateManager.LoadViewState(Object) |
Carrega o estado salvo anteriormente.Loads the previously saved state. (Herdado de Style) |
| IStateManager.SaveViewState() |
Retorna o objeto que contém as alterações de estado.Returns the object containing state changes. (Herdado de Style) |
| IStateManager.TrackViewState() |
Inicia o controle de alterações de estado.Starts tracking state changes. (Herdado de Style) |