MenuItemStyle Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa o estilo de um item de menu em um controle Menu. Essa classe não pode ser herdada.
public ref class MenuItemStyle sealed : System::Web::UI::WebControls::Stylepublic sealed class MenuItemStyle : System.Web.UI.WebControls.Styletype MenuItemStyle = class
inherit StylePublic 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 do DynamicMenuItemStyle, DynamicHoverStylee StaticMenuItemStyleStaticHoverStyle propriedades.
<%@ 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. Um item de menu é exibido em um menu estático ou em um menu dinâmico. 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. Você pode especificar características de estilo diferentes (como tamanho e cor da fonte) para cada um dos diferentes tipos de item de menu. A tabela a seguir lista os estilos de item de menu disponíveis.
| Propriedade de estilo de item de menu | Descrição |
|---|---|
| DynamicHoverStyle | As configurações de estilo de um item de menu dinâmico quando o ponteiro do mouse é posicionado sobre ele. |
| DynamicMenuItemStyle | As configurações de estilo de um item de menu dinâmico individual. |
| DynamicMenuStyle | As configurações de estilo para um menu dinâmico. |
| DynamicSelectedStyle | As configurações de estilo para o item de menu dinâmico selecionado no momento. |
| StaticHoverStyle | As configurações de estilo de um item de menu estático quando o ponteiro do mouse é posicionado sobre ele. |
| StaticMenuItemStyle | As configurações de estilo de um item de menu estático individual. |
| StaticMenuStyle | As configurações de estilo para um menu estático. |
| StaticSelectedStyle | As configurações de estilo para o item de menu estático selecionado no momento. |
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:
StaticMenuItemStyle. Se a LevelMenuItemStyles coleção ou LevelSubMenuStyles coleção for definida, ela será aplicada no momento, substituindo as outras propriedades de estilo de item de menu.
StaticSelectedStyle. Se a LevelSelectedStyles coleção for definida, ela será aplicada no momento, substituindo as outras propriedades de estilo de item de menu.
Da mesma forma, as propriedades de estilo de um item de menu dinâmico são aplicadas na seguinte ordem:
DynamicMenuItemStyle. Se a LevelMenuItemStyles coleção ou LevelSubMenuStyles coleção for definida, ela será aplicada no momento, substituindo as outras propriedades de estilo de item de menu.
DynamicSelectedStyle. Se a LevelSelectedStyles coleção for definida, ela será aplicada no momento, substituindo as outras propriedades de estilo de item de menu.
A MenuItemStyle classe herda a maioria de seus membros da Style classe. Ele estende a Style classe fornecendo propriedades que controlam a quantidade de espaço em torno do texto de um item de menu, bem como o espaço entre itens de menu adjacentes. Use a HorizontalPadding propriedade para controlar a quantidade de espaço à esquerda e à direita do texto do item de menu. Da mesma forma, a VerticalPadding propriedade controla a quantidade de espaço acima e abaixo do texto do item de menu. Você pode controlar a quantidade de espaçamento entre o item de menu ao qual o MenuItemStyle objeto é aplicado e seus itens de menu adjacentes definindo a ItemSpacing propriedade.
Para obter mais informações sobre as configurações de estilo herdadas, consulte Style.
Construtores
| MenuItemStyle() |
Inicializa uma nova instância da classe MenuItemStyle. |
| MenuItemStyle(StateBag) |
Inicializa uma nova instância da classe MenuItemStyle usando as informações de estado especificadas. |
Propriedades
| BackColor |
Obtém ou define a cor da tela de fundo do controle do servidor Web. (Herdado de Style) |
| BorderColor |
Obtém ou define a cor de borda do controle de servidor Web. (Herdado de Style) |
| BorderStyle |
Obtém ou define o estilo de borda do controle de servidor Web. (Herdado de Style) |
| BorderWidth |
Obtém ou define a largura da borda do controle de servidor Web. (Herdado de Style) |
| CanRaiseEvents |
Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component) |
| Container |
Obtém o IContainer que contém o 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. (Herdado de Style) |
| DesignMode |
Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component) |
| Events |
Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component) |
| Font |
Obtém as propriedades de fonte associadas ao controle do servidor Web. (Herdado de Style) |
| ForeColor |
Obtém ou define a cor de primeiro plano (normalmente a cor do texto) do controle de servidor Web. (Herdado de Style) |
| Height |
Obtém ou define a altura do controle do servidor Web. (Herdado de Style) |
| HorizontalPadding |
Obtém ou define a quantidade de espaço à esquerda e à direita do texto do item de menu. |
| IsEmpty |
Uma propriedade protegida. Obtém um valor que indica se algum elemento de estilo foi definido no recipiente de estados. (Herdado de Style) |
| IsTrackingViewState |
Retorna um valor que indica se algum elemento de estilo foi definido no recipiente de estados. (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. |
| RegisteredCssClass |
Obtém a classe CSS (folha de estilos em cascata) que está registrada com o controle. (Herdado de Style) |
| Site |
Obtém ou define o ISite do Component. (Herdado de Component) |
| VerticalPadding |
Obtém ou define a quantidade de espaço acima e abaixo do texto de um item de menu. |
| ViewState |
Obtém o recipiente de estados que contém os elementos de estilo. (Herdado de Style) |
| Width |
Obtém ou define a largura do controle de servidor Web. (Herdado de Style) |
Métodos
| AddAttributesToRender(HtmlTextWriter) |
Adiciona atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriter especificado. Esse método é usado principalmente por desenvolvedores de controles. (Herdado de Style) |
| AddAttributesToRender(HtmlTextWriter, WebControl) |
Adiciona atributos HTML e estilos que precisam ser renderizados ao controle de servidor Web HtmlTextWriter especificado. Esse método é usado principalmente por desenvolvedores de controles. (Herdado de Style) |
| CopyFrom(Style) |
Copia as propriedades de estilo do objeto Style especificado para a instância atual da classe MenuItemStyle. |
| 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. (Herdado de MarshalByRefObject) |
| Dispose() |
Libera todos os recursos usados pelo Component. (Herdado de Component) |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados. (Herdado de Component) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FillStyleAttributes(CssStyleCollection, IUrlResolutionService) |
Adiciona as propriedades de estilo do objeto especificado a um objeto CssStyleCollection. (Herdado de Style) |
| GetHashCode() |
Serve como a função de hash padrão. (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. (Herdado de MarshalByRefObject) |
| GetService(Type) |
Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component) |
| GetStyleAttributes(IUrlResolutionService) |
Recupera o objeto CssStyleCollection especificado objeto implementado por IUrlResolutionService. (Herdado de Style) |
| GetType() |
Obtém o Type da instância atual. (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. (Herdado de MarshalByRefObject) |
| LoadViewState(Object) |
Carrega o estado salvo anteriormente. (Herdado de Style) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject) |
| MergeWith(Style) |
Copia as propriedades de estilo do objeto Style especificado com aquelas da instância atual da classe MenuItemStyle. |
| Reset() |
Retorna a instância atual da classe MenuItemStyle ao seu estado original. |
| SaveViewState() |
Um método protegido. Salva qualquer estado que tenha sido modificado depois que o método TrackViewState() foi invocado. (Herdado de Style) |
| SetBit(Int32) |
Um método interno protegido. Define um campo interno de máscara de bits que indica as propriedades de estilo que estão armazenadas no recipiente de estados. (Herdado de Style) |
| SetDirty() |
Marca o Style de maneira que seu estado seja registrado na exibição de estado. (Herdado de Style) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Style) |
| TrackViewState() |
Um método protegido. Marca o início para controlar alterações de estado no controle. 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. (Herdado de Style) |
Eventos
| Disposed |
Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (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. (Herdado de Style) |
| IStateManager.LoadViewState(Object) |
Carrega o estado salvo anteriormente. (Herdado de Style) |
| IStateManager.SaveViewState() |
Retorna o objeto que contém as alterações de estado. (Herdado de Style) |
| IStateManager.TrackViewState() |
Inicia o controle de alterações de estado. (Herdado de Style) |