MenuItemStyle Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa o estilo de um item de menu num Menu controlo. Esta 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 seguinte demonstra como controlar a aparência dos itens do menu num Menu controlo, definindo as propriedades de estilo do MenuItemStyle objeto devolvido pelas DynamicMenuItemStylepropriedades , DynamicHoverStyle, StaticMenuItemStyle, e StaticHoverStyle .


<%@ 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>

Observações

Use a MenuItemStyle classe para representar o estilo de um item de menu no Menu controlo. Um item do menu é exibido num menu estático ou num menu dinâmico. Um menu estático é sempre exibido num Menu controlo, enquanto um menu dinâmico é exibido apenas quando o utilizador posiciona o ponteiro do rato sobre um elemento do menu pai que contém um submenu dinâmico. Pode especificar diferentes características de estilo (como tamanho e cor da fonte) para cada um dos diferentes tipos de itens do menu. A tabela seguinte lista os estilos de itens disponíveis no menu.

Propriedade do estilo dos itens do menu	Descrição
DynamicHoverStyle	As definições de estilo para um item dinâmico do menu quando o ponteiro do rato está posicionado por cima.
DynamicMenuItemStyle	As definições de estilo para um item dinâmico individual do menu.
DynamicMenuStyle	As definições de estilo para um menu dinâmico.
DynamicSelectedStyle	As definições de estilo para o item do menu dinâmico atualmente selecionado.
StaticHoverStyle	As definições de estilo para um item de menu estático quando o ponteiro do rato está posicionado por cima.
StaticMenuItemStyle	As definições de estilo para um item estático individual do menu.
StaticMenuStyle	As definições de estilo para um menu estático.
StaticSelectedStyle	As definições de estilo para o item de menu estático atualmente selecionado.

Quando múltiplas propriedades de estilo são definidas para um item de menu estático, as propriedades de estilo são aplicadas pela seguinte ordem:

StaticMenuStyle.
StaticMenuItemStyle. Se a LevelMenuItemStyles coleção ou LevelSubMenuStyles coleção estiver definida, é aplicada neste momento, sobrescrevendo as outras propriedades do estilo dos itens do menu.
StaticSelectedStyle. Se a LevelSelectedStyles coleção estiver definida, é aplicada neste momento, sobrepondo-se às propriedades do estilo dos outros itens do menu.
StaticHoverStyle.

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

DynamicMenuStyle.
DynamicMenuItemStyle. Se a LevelMenuItemStyles coleção ou LevelSubMenuStyles coleção estiver definida, é aplicada neste momento, sobrescrevendo as outras propriedades do estilo dos itens do menu.
DynamicSelectedStyle. Se a LevelSelectedStyles coleção estiver definida, é aplicada neste momento, sobrepondo-se às propriedades do estilo dos outros itens do menu.
DynamicHoverStyle.

A MenuItemStyle classe herda a maioria dos seus membros da Style classe. Estende a Style classe ao fornecer propriedades que controlam a quantidade de espaço em redor do texto de um item do menu, bem como o espaço entre itens adjacentes do menu. Use a HorizontalPadding propriedade para controlar o espaço à esquerda e à direita do texto do item do menu. De forma semelhante, a VerticalPadding propriedade controla a quantidade de espaço acima e abaixo do texto do item do menu. Podes controlar a quantidade de espaçamento entre o item do menu a que o MenuItemStyle objeto é aplicado e os seus itens adjacentes definindo a ItemSpacing propriedade.

Para mais informações sobre as definições de estilo herdadas, veja Style.

Construtores

Name	Description
MenuItemStyle()	Inicializa uma nova instância da MenuItemStyle classe.
MenuItemStyle(StateBag)	Inicializa uma nova instância da MenuItemStyle classe usando a informação de estado especificada.

Propriedades

Name	Description
BackColor	Obtém ou define a cor de fundo do controlo do servidor Web. (Herdado de Style)
BorderColor	Obtém ou define a cor da borda do controlo do servidor Web. (Herdado de Style)
BorderStyle	Obtém ou define o estilo de borda do controlo do servidor Web. (Herdado de Style)
BorderWidth	Obtém ou define a largura da fronteira do controlo do servidor Web. (Herdado de Style)
CanRaiseEvents	Obtém um valor que indica se o componente pode gerar 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 de folha de estilo em cascata (CSS) renderizada pelo controlo do servidor Web no cliente. (Herdado de Style)
DesignMode	Obtém um valor que indica se o Component está atualmente em modo de design. (Herdado de Component)
Events	Obtém a lista de gestores de eventos que estão ligados a isto Component. (Herdado de Component)
Font	Obtém as propriedades da fonte associadas ao controlo do servidor Web. (Herdado de Style)
ForeColor	Obtém ou define a cor do primeiro plano (tipicamente a cor do texto) do controlo do servidor Web. (Herdado de Style)
Height	Obtém ou define a altura do controlo do servidor Web. (Herdado de Style)
HorizontalPadding	Obtém ou define a quantidade de espaço à esquerda e à direita do texto do item do menu.
IsEmpty	Uma propriedade protegida. Obtém um valor que indica se algum elemento de estilo foi definido no saco de estados. (Herdado de Style)
IsTrackingViewState	Devolve um valor que indica se algum elemento de estilo foi definido no saco de estados. (Herdado de Style)
ItemSpacing	Obtém ou define a quantidade de espaçamento vertical entre o item do menu ao qual o MenuItemStyle objeto é aplicado e os itens adjacentes do menu.
RegisteredCssClass	Recebe a classe de folha de estilo em cascata (CSS) que está registada no controlo. (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 do menu.
ViewState	Fica com a bolsa de estado que contém os elementos de estilo. (Herdado de Style)
Width	Obtém ou define a largura do controlo do servidor Web. (Herdado de Style)

Métodos

Name	Description
AddAttributesToRender(HtmlTextWriter, WebControl)	Adiciona atributos e estilos HTML que precisam de ser renderizados para o controlo especificado HtmlTextWriter e do servidor Web. Este método é usado principalmente por desenvolvedores de controlo. (Herdado de Style)
AddAttributesToRender(HtmlTextWriter)	Adiciona atributos e estilos HTML que precisam de ser renderizados para o especificado HtmlTextWriter. Este método é usado principalmente por desenvolvedores de controlo. (Herdado de Style)
CopyFrom(Style)	Copia as propriedades de estilo do objeto especificado Style para a instância atual da MenuItemStyle classe.
CreateObjRef(Type)	Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Liberta todos os recursos utilizados pelo Component. (Herdado de Component)
Dispose(Boolean)	Liberta os recursos não geridos usados pelo Component e opcionalmente liberta os recursos geridos. (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 CssStyleCollection objeto. (Herdado de Style)
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject)
GetService(Type)	Devolve um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetStyleAttributes(IUrlResolutionService)	Recupera o CssStyleCollection objeto para o objeto especificado IUrlResolutionServiceem -implementado. (Herdado de Style)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject)
LoadViewState(Object)	Carrega o estado guardado anteriormente. (Herdado de Style)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject)
MergeWith(Style)	Combina as propriedades de estilo do objeto especificado Style com as da instância atual da MenuItemStyle classe.
Reset()	Devolve a instância atual da MenuItemStyle classe ao seu estado original.
SaveViewState()	Um método protegido. Guarda qualquer estado que tenha sido modificado após o TrackViewState() método ter sido invocado. (Herdado de Style)
SetBit(Int32)	Um método interno protegido. Define um campo interno de bitmask que indica as propriedades de estilo armazenadas no state bag. (Herdado de Style)
SetDirty()	Marca o Style para que o seu estado seja registado no estado de visualização. (Herdado de Style)
TrackViewState()	Um método protegido. Marca o início para acompanhar as alterações de estado no controlo. Quaisquer alterações feitas após o início do rastreamento serão registadas e guardadas como parte do estado da vista de controlo. (Herdado de Style)

evento

Name	Description
Disposed	Ocorre quando o componente é eliminado por uma chamada ao Dispose() método. (Herdado de Component)

Implementações de Interface Explícita

Name	Description
IStateManager.IsTrackingViewState	Obtém um valor que indica se um controlo de servidor está a acompanhar as alterações no estado da sua visualização. (Herdado de Style)
IStateManager.LoadViewState(Object)	Carrega o estado guardado anteriormente. (Herdado de Style)
IStateManager.SaveViewState()	Devolve o objeto que contém alterações de estado. (Herdado de Style)
IStateManager.TrackViewState()	Começa a acompanhar as alterações de estado. (Herdado de Style)

Aplica-se a

Ver também

Comentários

Esta página foi útil?