MenuItemStyle Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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::Style

public sealed class MenuItemStyle : System.Web.UI.WebControls.Style

type MenuItemStyle = class
    inherit Style

Public NotInheritable Class MenuItemStyle
Inherits Style

Herança: Object

MarshalByRefObject

Component

Style
MenuItemStyle

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 StaticMenuItemStyle StaticHoverStyle 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:

StaticMenuStyle.
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.
StaticHoverStyle.

Da mesma forma, as propriedades de estilo de um item de menu dinâmico são aplicadas na seguinte ordem:

DynamicMenuStyle.
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.
DynamicHoverStyle.

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)

Aplica-se a

Partilhar via