MenuItemStyle 類別

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

表示 Menu 控制項中的功能表項目樣式。此類別無法獲得繼承。

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

繼承: Object

MarshalByRefObject

Component

Style
MenuItemStyle

範例

下列程式碼範例示範如何藉由設定從 DynamicMenuItemStyle 、 StaticMenuItemStyle DynamicHoverStyle 、和 StaticHoverStyle 屬性傳回之物件的樣式屬性 MenuItemStyle ，來控制控制項中 Menu 功能表項目的外觀。


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

備註

MenuItemStyle使用類別來表示控制項中 Menu 功能表項目的樣式。功能表項目會顯示在靜態功能表或動態功能表中。靜態功能表一律會顯示在控制項中 Menu ，而動態功能表只有在使用者將滑鼠指標放在包含動態子功能表的父功能表項目上方時才會顯示。您可以為每個不同的功能表項目類型指定不同的樣式特性 (，例如字型大小和色彩) 。下表列出可用的功能表項目樣式。

功能表項目樣式屬性	描述
DynamicHoverStyle	當滑鼠指標置於動態功能表項目上方時，動態功能表項目的樣式設定。
DynamicMenuItemStyle	個別動態功能表項目的樣式設定。
DynamicMenuStyle	動態功能表的樣式設定。
DynamicSelectedStyle	目前選取之動態功能表項目的樣式設定。
StaticHoverStyle	當滑鼠指標放在靜態功能表項目上方時，其樣式設定。
StaticMenuItemStyle	個別靜態功能表項目的樣式設定。
StaticMenuStyle	靜態功能表的樣式設定。
StaticSelectedStyle	目前選取之靜態功能表項目的樣式設定。

設定靜態功能表項目的多個樣式屬性時，會依照下列順序套用樣式屬性：

StaticMenuStyle.
StaticMenuItemStyle. LevelMenuItemStyles如果已定義集合或 LevelSubMenuStyles 集合，則此時會套用該集合，並覆寫其他功能表項目樣式屬性。
StaticSelectedStyle. LevelSelectedStyles如果已定義集合，則此時會套用該集合，並覆寫其他功能表項目樣式屬性。
StaticHoverStyle.

同樣地，動態功能表項目的樣式屬性會依下列順序套用：

DynamicMenuStyle.
DynamicMenuItemStyle. LevelMenuItemStyles如果已定義集合或 LevelSubMenuStyles 集合，則此時會套用該集合，並覆寫其他功能表項目樣式屬性。
DynamicSelectedStyle. LevelSelectedStyles如果已定義集合，則此時會套用該集合，並覆寫其他功能表項目樣式屬性。
DynamicHoverStyle.

類別 MenuItemStyle 會繼承 Style 類別的大部分成員。它會藉由提供屬性來控制功能表項目文字周圍的空間量，以及相鄰功能表項目之間的空格，來擴充 Style 類別。 HorizontalPadding使用屬性來控制功能表項目文字左邊和右邊的空間量。同樣地， VerticalPadding 屬性會控制功能表項目文字上方和下方的空間量。您可以藉由設定 ItemSpacing 屬性，控制物件套用至的功能表項目 MenuItemStyle 與其相鄰功能表項目之間的間距量。

如需繼承樣式設定的詳細資訊，請參閱 Style 。

建構函式

MenuItemStyle()	初始化 MenuItemStyle 類別的新執行個體。
MenuItemStyle(StateBag)	使用指定的狀態資訊，初始化 MenuItemStyle 類別的新執行個體。

屬性

BackColor	取得或設定 Web 伺服器控制項的背景色彩。 (繼承來源 Style)
BorderColor	取得或設定 Web 伺服器控制項的框線色彩。 (繼承來源 Style)
BorderStyle	取得或設定 Web 伺服器控制項的框線樣式。 (繼承來源 Style)
BorderWidth	取得或設定 Web 伺服器控制項的框線寬度。 (繼承來源 Style)
CanRaiseEvents	取得值，指出元件是否能引發事件。 (繼承來源 Component)
Container	取得包含 IContainer 的 Component。 (繼承來源 Component)
CssClass	取得或設定用戶端上 Web 伺服器控制項所呈現的階層式樣式表 (CSS)。 (繼承來源 Style)
DesignMode	取得值，指出 Component 目前是否處於設計模式。 (繼承來源 Component)
Events	取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component)
Font	取得與 Web 伺服器控制項關聯的字型屬性。 (繼承來源 Style)
ForeColor	取得或設定 Web 伺服器控制項的前景色彩 (通常是文字的色彩)。 (繼承來源 Style)
Height	取得或設定 Web 伺服器控制項的高度。 (繼承來源 Style)
HorizontalPadding	取得或設定功能表項目文字左側和右側的間距。
IsEmpty	保護的 (Protected) 屬性。取得值，指出狀態包中是否已定義任何樣式項目。 (繼承來源 Style)
IsTrackingViewState	傳回值，指出是否任何的樣式項目都已經在狀態包中定義。 (繼承來源 Style)
ItemSpacing	取得或設定套用 MenuItemStyle 物件之功能表項目與其相鄰功能表項目的垂直間距。
RegisteredCssClass	取得使用控制項註冊的階層式樣式表 (CSS) 類別。 (繼承來源 Style)
Site	取得或設定 Component 的 ISite。 (繼承來源 Component)
VerticalPadding	取得或設定功能表項目文字上方和下方的間距。
ViewState	取得保存樣式項目的狀態包。 (繼承來源 Style)
Width	取得或設定 Web 伺服器控制項的寬度。 (繼承來源 Style)

方法

AddAttributesToRender(HtmlTextWriter)	將需要呈現的 HTML 屬性和樣式加入至指定的 HtmlTextWriter 中。這個方法主要由控制項開發人員使用。 (繼承來源 Style)
AddAttributesToRender(HtmlTextWriter, WebControl)	將需要呈現的 HTML 屬性和樣式加入至指定的 HtmlTextWriter 和 Web 伺服器控制項中。這個方法主要由控制項開發人員使用。 (繼承來源 Style)
CopyFrom(Style)	將指定 Style 物件的樣式屬性複製到 MenuItemStyle 類別的目前執行個體中。
CreateObjRef(Type)	建立包含所有相關資訊的物件，這些資訊是產生用來與遠端物件通訊的所需 Proxy。 (繼承來源 MarshalByRefObject)
Dispose()	釋放 Component 所使用的所有資源。 (繼承來源 Component)
Dispose(Boolean)	釋放 Component 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 Component)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
FillStyleAttributes(CssStyleCollection, IUrlResolutionService)	將指定物件的樣式屬性加入 CssStyleCollection 物件中。 (繼承來源 Style)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLifetimeService()	已淘汰. 擷取控制這個執行個體存留期 (Lifetime) 原則的目前存留期服務物件。 (繼承來源 MarshalByRefObject)
GetService(Type)	傳回表示 Component 或其 Container 所提供之服務的物件。 (繼承來源 Component)
GetStyleAttributes(IUrlResolutionService)	擷取指定 CssStyleCollection 實作物件的 IUrlResolutionService 物件。 (繼承來源 Style)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
InitializeLifetimeService()	已淘汰. 取得存留期服務物件，以控制這個執行個體的存留期原則。 (繼承來源 MarshalByRefObject)
LoadViewState(Object)	載入先前儲存的狀態。 (繼承來源 Style)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MemberwiseClone(Boolean)	建立目前 MarshalByRefObject 物件的淺層複本。 (繼承來源 MarshalByRefObject)
MergeWith(Style)	將指定 Style 物件的樣式屬性與 MenuItemStyle 類別目前執行個體的樣式屬性結合。
Reset()	讓 MenuItemStyle 類別的目前執行個體返回其原始狀態。
SaveViewState()	保護的 (Protected) 方法。儲存叫用 TrackViewState() 方法之後，任何已變更的狀態。 (繼承來源 Style)
SetBit(Int32)	保護的內部方法。設定內部位元遮罩欄位，表示儲存在狀態包中的樣式屬性。 (繼承來源 Style)
SetDirty()	標記 Style，以便將其狀態記錄在檢視狀態中。 (繼承來源 Style)
ToString()	傳回代表目前物件的字串。 (繼承來源 Style)
TrackViewState()	保護的 (Protected) 方法。在控制項上標記追蹤狀態變更的開頭。任何在追蹤開始後的變更都會被追蹤，並儲存成控制項檢視狀態的一部分。 (繼承來源 Style)

事件

Disposed

當 Dispose() 方法的呼叫處置元件時，就會發生。

(繼承來源 Component)

明確介面實作

IStateManager.IsTrackingViewState	取得值，指出伺服器控制項是否正在追蹤其檢視狀態變更。 (繼承來源 Style)
IStateManager.LoadViewState(Object)	載入先前儲存的狀態。 (繼承來源 Style)
IStateManager.SaveViewState()	傳回包含狀態變更的物件。 (繼承來源 Style)
IStateManager.TrackViewState()	啟動追蹤狀態的變更。 (繼承來源 Style)

適用於

共用方式為

MenuItemStyle 類別

定義

範例

備註

建構函式

屬性

方法

事件

明確介面實作

適用於

另請參閱

其他資源