MenuItemStyle Класс

Определение

Представляет стиль пункта меню в элементе управления Menu.Represents the style of a menu item in a Menu control. Этот класс не наследуется.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
Наследование

Примеры

В следующем примере кода показано, как управлять внешним Menu видом пунктов меню в элементе управления путем задания свойств MenuItemStyle стиля объекта DynamicMenuItemStyle, StaticMenuItemStyleвозвращаемого из, DynamicHoverStyle, и 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>

Комментарии

Используйте класс для представления стиля пункта меню Menu в элементе управления. MenuItemStyleUse the MenuItemStyle class to represent the style of a menu item in the Menu control. Пункт меню отображается как в статическом меню, так и в динамическом меню.A menu item is displayed in either a static menu or a dynamic menu. В Menu элементе управления всегда отображается статическое меню, в то время как динамическое меню отображается только в том случае, если пользователь позиционирует указатель мыши на родительский элемент меню, содержащий динамическое подменю.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. Для каждого из различных типов пунктов меню можно указать различные характеристики стиля (например, размер и цвет шрифта).You can specify different style characteristics (such as font size and color) for each of the different menu item types. В следующей таблице перечислены доступные стили пунктов меню.The following table lists the available menu item styles.

Свойство стиля пункта менюMenu item style property ОписаниеDescription
DynamicHoverStyle Параметры стиля для элемента динамического меню при помещении на него указателя мыши.The style settings for a dynamic menu item when the mouse pointer is positioned over it.
DynamicMenuItemStyle Параметры стиля для отдельного элемента динамического меню.The style settings for an individual dynamic menu item.
DynamicMenuStyle Параметры стиля для динамического меню.The style settings for a dynamic menu.
DynamicSelectedStyle Параметры стиля для выбранного в данный момент элемента динамического меню.The style settings for the currently selected dynamic menu item.
StaticHoverStyle Параметры стиля для элемента статического меню при помещении на него указателя мыши.The style settings for a static menu item when the mouse pointer is positioned over it.
StaticMenuItemStyle Параметры стиля для отдельного элемента статического меню.The style settings for an individual static menu item.
StaticMenuStyle Параметры стиля для статического меню.The style settings for a static menu.
StaticSelectedStyle Параметры стиля для выбранного в данный момент элемента статического меню.The style settings for the currently selected static menu item.

Если для элемента статического меню задано несколько свойств стиля, свойства стиля применяются в следующем порядке: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. Если коллекция или LevelSubMenuStyles коллекция определены, они применяются в этот момент, переопределяя другие свойства стиля элемента меню. LevelMenuItemStylesIf the LevelMenuItemStyles collection or LevelSubMenuStyles collection is defined, it is applied at this time, overriding the other menu item style properties.

  3. StaticSelectedStyle.StaticSelectedStyle. LevelSelectedStyles Если коллекция определена, она применяется в этот момент, переопределяя другие свойства стиля элемента меню.If the LevelSelectedStyles collection is defined, it is applied at this time, overriding the other menu item style properties.

  4. StaticHoverStyle.StaticHoverStyle.

Аналогичным образом, свойства стиля для элемента динамического меню применяются в следующем порядке:Likewise, the style properties for a dynamic menu item are applied in the following order:

  1. DynamicMenuStyle.DynamicMenuStyle.

  2. DynamicMenuItemStyle.DynamicMenuItemStyle. Если коллекция или LevelSubMenuStyles коллекция определены, они применяются в этот момент, переопределяя другие свойства стиля элемента меню. LevelMenuItemStylesIf the LevelMenuItemStyles collection or LevelSubMenuStyles collection is defined, it is applied at this time, overriding the other menu item style properties.

  3. DynamicSelectedStyle.DynamicSelectedStyle. LevelSelectedStyles Если коллекция определена, она применяется в этот момент, переопределяя другие свойства стиля элемента меню.If the LevelSelectedStyles collection is defined, it is applied at this time, overriding the other menu item style properties.

  4. DynamicHoverStyle.DynamicHoverStyle.

Класс наследует большинство его членов Style от класса. MenuItemStyleThe MenuItemStyle class inherits most of its members from the Style class. Он расширяет Style класс, предоставляя свойства, управляющие объемом пространства вокруг текста пункта меню, а также пространство между соседними пунктами меню.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. HorizontalPadding Используйте свойство, чтобы управлять объемом пространства слева и справа от текста элемента меню.Use the HorizontalPadding property to control the amount of space to the left and right of the menu item's text. Аналогично, VerticalPadding свойство управляет объемом пространства выше и под текстом пункта меню.Similarly, the VerticalPadding property controls the amount of space above and below the menu item's text. Можно управлять расстоянием между пунктом меню, к которому применяется MenuItemStyle объект, и соседними элементами меню, ItemSpacing задавая свойство.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.

Дополнительные сведения о наследуемых параметрах стиля см Style. в разделе.For more information on the inherited style settings, see Style.

Конструкторы

MenuItemStyle()

Инициализирует новый экземпляр класса MenuItemStyle.Initializes a new instance of the MenuItemStyle class.

MenuItemStyle(StateBag)

Инициализирует новый экземпляр класса MenuItemStyle, используя указанную информацию о статусе.Initializes a new instance of the MenuItemStyle class using the specified state information.

Свойства

BackColor

Получает или задает цвет фона серверного веб-элемента управления.Gets or sets the background color of the Web server control.

(Унаследовано от Style)
BorderColor

Получает или задает цвет границы для серверного веб-элемента управления.Gets or sets the border color of the Web server control.

(Унаследовано от Style)
BorderStyle

Получает или задает стиль границы серверного веб-элемента управления.Gets or sets the border style of the Web server control.

(Унаследовано от Style)
BorderWidth

Возвращает или задает ширину границы серверного веб-элемента управления.Gets or sets the border width of the Web server control.

(Унаследовано от Style)
CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Унаследовано от Component)
Container

Возвращает контейнер IContainer, содержащий компонент Component.Gets the IContainer that contains the Component.

(Унаследовано от Component)
CssClass

Получает или задает класс каскадных таблицы стилей (CSS), отрисовываемый для просмотра в серверном веб-элементе управления на клиентском компьютере.Gets or sets the cascading style sheet (CSS) class rendered by the Web server control on the client.

(Унаследовано от Style)
DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Унаследовано от Component)
Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Унаследовано от Component)
Font

Возвращает свойства шрифта, связанные с серверным веб-элементом управления.Gets the font properties associated with the Web server control.

(Унаследовано от Style)
ForeColor

Возвращает или задает основной цвет (обычно это цвет текста) для серверного веб-элемента управления.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Унаследовано от Style)
Height

Получает или задает высоту серверного веб-элемента управления.Gets or sets the height of the Web server control.

(Унаследовано от Style)
HorizontalPadding

Получает или задает число отступа справа и слева от текста элемента меню.Gets or sets the amount of space to the left and right of the menu item's text.

IsEmpty

Защищенное свойство.A protected property. Получает значение, которое указывает, были ли определены в наборе состояний какие-либо элементы стиля.Gets a value indicating whether any style elements have been defined in the state bag.

(Унаследовано от Style)
IsTrackingViewState

Получает значение, позволяющее определить, были ли определены в наборе состояний какие-либо элементы стиля.Returns a value indicating whether any style elements have been defined in the state bag.

(Унаследовано от Style)
ItemSpacing

Получает или задает вертикальный отступ между элементом меню, к которому применен объект MenuItemStyle, а также его смежными элементами меню.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

Возвращает класс каскадных таблиц стилей (CSS), зарегистрированный с использованием элемента управления.Gets the cascading style sheet (CSS) class that is registered with the control.

(Унаследовано от Style)
Site

Возвращает или задает ISite объекта Component.Gets or sets the ISite of the Component.

(Унаследовано от Component)
VerticalPadding

Получает или задает число отступа сверху и снизу от текста элемента меню.Gets or sets the amount of space above and below a menu item's text.

ViewState

Получает или задает набор состояний, в котором хранятся элементы стиля.Gets the state bag that holds the style elements.

(Унаследовано от Style)
Width

Получает или задает ширину серверного веб-элемента управления.Gets or sets the width of the Web server control.

(Унаследовано от Style)

Методы

AddAttributesToRender(HtmlTextWriter)

Добавляет атрибуты и стили HTML, которые должны быть отображены в указанном элементе управления HtmlTextWriter.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter. Этот метод, в основном, используется разработчиками элементов управления.This method is primarily used by control developers.

(Унаследовано от Style)
AddAttributesToRender(HtmlTextWriter, WebControl)

Добавляет атрибуты и стили HTML, которые нужно обработать для просмотра в указанном элементе управления HtmlTextWriter, а также серверном веб-элементе управления.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriter and Web server control. Этот метод, в основном, используется разработчиками элементов управления.This method is primarily used by control developers.

(Унаследовано от Style)
CopyFrom(Style)

Копирует свойства стиля указанного объекта Style в текущий экземпляр класса MenuItemStyle.Copies the style properties of the specified Style object into the current instance of the MenuItemStyle class.

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, занятые модулем Component.Releases all resources used by the Component.

(Унаследовано от Component)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Унаследовано от Component)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
FillStyleAttributes(CssStyleCollection, IUrlResolutionService)

Добавляет свойства стиля указанного объекта в объект CssStyleCollection.Adds the specified object's style properties to a CssStyleCollection object.

(Унаследовано от Style)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
GetService(Type)

Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container.Returns an object that represents a service provided by the Component or by its Container.

(Унаследовано от Component)
GetStyleAttributes(IUrlResolutionService)

Извлекает объект CssStyleCollection для заданного объекта, реализующего интерфейс IUrlResolutionService.Retrieves the CssStyleCollection object for the specified IUrlResolutionService-implemented object.

(Унаследовано от Style)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
LoadViewState(Object)

Загружает сохраненное ранее состояние.Loads the previously saved state.

(Унаследовано от Style)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от MarshalByRefObject)
MergeWith(Style)

Совмещает свойства стиля указанного объекта Style со свойствами текущего экземпляр класса MenuItemStyle.Combines the style properties of the specified Style object with those of the current instance of the MenuItemStyle class.

Reset()

Возвращает текущую реализацию класса MenuItemStyle в исходное состояние.Returns the current instance of the MenuItemStyle class to its original state.

SaveViewState()

Защищенный метод.A protected method. Сохраняет все состояния, претерпевшие изменения после вызова метода TrackViewState().Saves any state that has been modified after the TrackViewState() method was invoked.

(Унаследовано от Style)
SetBit(Int32)

Защищенный внутренний метод.A protected internal method. Задает внутреннюю битовую маску, которая позволяет определить свойства стиля, сохраненные в наборе состояний.Sets an internal bitmask field that indicates the style properties that are stored in the state bag.

(Унаследовано от Style)
SetDirty()

Обозначает объект Style для записи его состояния в данные о состоянии представления.Marks the Style so that its state will be recorded in view state.

(Унаследовано от Style)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Style)
TrackViewState()

Защищенный метод.A protected method. Обозначает начало отслеживания изменений состояния в элементе управления.Marks the beginning for tracking state changes on the control. Любые изменения, внесенные с момента начала отслеживания, сохраняются в данных о состоянии представления элемента управления.Any changes made after tracking has begun will be tracked and saved as part of the control view state.

(Унаследовано от Style)

События

Disposed

Происходит при удалении компонента вызовом метода Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Унаследовано от Component)

Явные реализации интерфейса

IStateManager.IsTrackingViewState

Получает значение, позволяющее определить, отслеживается ли изменение состояния представления серверного элемента управления.Gets a value that indicates whether a server control is tracking its view state changes.

(Унаследовано от Style)
IStateManager.LoadViewState(Object)

Загружает сохраненное ранее состояние.Loads the previously saved state.

(Унаследовано от Style)
IStateManager.SaveViewState()

Возвращает объект, содержащий данные об изменении состояния.Returns the object containing state changes.

(Унаследовано от Style)
IStateManager.TrackViewState()

Запускает отслеживание изменений состояния.Starts tracking state changes.

(Унаследовано от Style)

Применяется к

Дополнительно