MenuItemStyle Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt den Stil eines Menüelements in einem Menu-Steuerelement dar. Diese Klasse kann nicht vererbt werden.

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

Vererbung: Object

MarshalByRefObject

Component

Style
MenuItemStyle

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Darstellung der Menüelemente in einem Menu Steuerelement steuern, indem Sie die Formatvorlageneigenschaften des Objekts festlegen, das MenuItemStyle von den DynamicMenuItemStyleEigenschaften , DynamicHoverStyle, StaticMenuItemStyleund StaticHoverStyle zurückgegeben wird.


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

Hinweise

Verwenden Sie die MenuItemStyle -Klasse, um den Stil eines Menüelements im Menu Steuerelement darzustellen. Ein Menüelement wird entweder in einem statischen Menü oder einem dynamischen Menü angezeigt. In einem Steuerelement wird immer ein Menu statisches Menü angezeigt, während ein dynamisches Menü nur angezeigt wird, wenn der Benutzer den Mauszeiger auf einem übergeordneten Menüelement positioniert, das ein dynamisches Untermenü enthält. Sie können unterschiedliche Stilmerkmale (z. B. Schriftgrad und Farbe) für jeden der verschiedenen Menüelementtypen angeben. In der folgenden Tabelle sind die verfügbaren Menüelementstile aufgeführt.

Menüelementformateigenschaft	BESCHREIBUNG
DynamicHoverStyle	Die Stileinstellungen für ein dynamisches Menüelement, wenn der Mauszeiger darüber positioniert wird.
DynamicMenuItemStyle	Die Stileinstellungen für ein einzelnes dynamisches Menüelement.
DynamicMenuStyle	Die Stileinstellungen für ein dynamisches Menü.
DynamicSelectedStyle	Die Stileinstellungen für das aktuell ausgewählte dynamische Menüelement.
StaticHoverStyle	Die Stileinstellungen für ein statisches Menüelement, wenn der Mauszeiger darüber positioniert wird.
StaticMenuItemStyle	Die Formateinstellungen für ein einzelnes statisches Menüelement.
StaticMenuStyle	Die Stileinstellungen für ein statisches Menü.
StaticSelectedStyle	Die Stileinstellungen für das aktuell ausgewählte statische Menüelement.

Wenn mehrere Formatvorlageneigenschaften für ein statisches Menüelement festgelegt werden, werden die Formatvorlageneigenschaften in der folgenden Reihenfolge angewendet:

StaticMenuStyle.
StaticMenuItemStyle. Wenn die LevelMenuItemStyles Auflistung oder LevelSubMenuStyles Auflistung definiert ist, wird sie zu diesem Zeitpunkt angewendet und die anderen Eigenschaften des Menüelementstils überschrieben.
StaticSelectedStyle. Wenn die LevelSelectedStyles Auflistung definiert ist, wird sie zu diesem Zeitpunkt angewendet, wobei die anderen Eigenschaften des Menüelementstils überschrieben werden.
StaticHoverStyle.

Ebenso werden die Formateigenschaften für ein dynamisches Menüelement in der folgenden Reihenfolge angewendet:

DynamicMenuStyle.
DynamicMenuItemStyle. Wenn die LevelMenuItemStyles Auflistung oder LevelSubMenuStyles Auflistung definiert ist, wird sie zu diesem Zeitpunkt angewendet und die anderen Eigenschaften des Menüelementstils überschrieben.
DynamicSelectedStyle. Wenn die LevelSelectedStyles Auflistung definiert ist, wird sie zu diesem Zeitpunkt angewendet, wobei die anderen Eigenschaften des Menüelementstils überschrieben werden.
DynamicHoverStyle.

Die MenuItemStyle -Klasse erbt die meisten Ihrer Member von der Style -Klasse. Die -Klasse wird erweitert Style , indem Eigenschaften bereitgestellt werden, die die Menge des Platzes um den Text eines Menüelements sowie den Abstand zwischen benachbarten Menüelementen steuern. Verwenden Sie die HorizontalPadding -Eigenschaft, um den Platz links und rechts neben dem Text des Menüelements zu steuern. Auf ähnliche Weise steuert die VerticalPadding -Eigenschaft den Platz über und unter dem Text des Menüelements. Sie können den Abstand zwischen dem Menüelement, auf das das Objekt angewendet wird, und den MenuItemStyle angrenzenden Menüelementen steuern, indem Sie die ItemSpacing -Eigenschaft festlegen.

Weitere Informationen zu den geerbten Stileinstellungen finden Sie unter Style.

Konstruktoren

MenuItemStyle()	Initialisiert eine neue Instanz der MenuItemStyle-Klasse.
MenuItemStyle(StateBag)	Initialisiert eine neue Instanz der MenuItemStyle-Klasse unter Verwendung der angegebenen Zustandsinformationen.

Eigenschaften

BackColor	Ruft die Hintergrundfarbe des Webserversteuerelements ab oder legt diese fest. (Geerbt von Style)
BorderColor	Ruft die Rahmenfarbe des Webserversteuerelements ab oder legt diese fest. (Geerbt von Style)
BorderStyle	Ruft die Rahmenart des Webserversteuerelements ab oder legt diese fest. (Geerbt von Style)
BorderWidth	Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest. (Geerbt von Style)
CanRaiseEvents	Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
Container	Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component)
CssClass	Ruft die vom Webserver-Steuerelement auf dem Client gerenderte CSS-Klasse (Cascading Style Sheet) ab oder legt diese fest. (Geerbt von Style)
DesignMode	Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component)
Events	Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component)
Font	Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind. (Geerbt von Style)
ForeColor	Ruft die Vordergrundfarbe (i. A. die Textfarbe) für das Webserversteuerelement ab oder legt diese fest. (Geerbt von Style)
Height	Ruft die Höhe des Webserversteuerelements ab oder legt diese fest. (Geerbt von Style)
HorizontalPadding	Ruft den Abstand links und rechts vom Text des Menüelements ab oder legt diesen fest.
IsEmpty	Eine geschützte Eigenschaft. Ruft einen Wert ab, der angibt, ob in der Datenauflistung Stilelemente definiert wurden. (Geerbt von Style)
IsTrackingViewState	Gibt einen Wert zurück, der angibt, ob in der Datenauflistung Stilelemente definiert wurden. (Geerbt von Style)
ItemSpacing	Ruft den vertikalen Abstand zwischen dem Menüelement, auf das das MenuItemStyle-Objekt angewendet wird, und den benachbarten Menüelementen ab oder legt diesen fest.
RegisteredCssClass	Ruft die für das Steuerelement registrierte CSS-Klasse (Cascading Style Sheet) ab. (Geerbt von Style)
Site	Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
VerticalPadding	Ruft den Abstand über und unter dem Text eines Menüelements ab oder legt diesen fest.
ViewState	Ruft die Datenauflistung ab, die die Stilelemente enthält. (Geerbt von Style)
Width	Ruft die Breite des Webserver-Steuerelements ab oder legt sie fest. (Geerbt von Style)

Methoden

AddAttributesToRender(HtmlTextWriter)	Fügt dem angegebenen HtmlTextWriter die darzustellenden HTML-Attribute und -Stile hinzu. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von Style)
AddAttributesToRender(HtmlTextWriter, WebControl)	Fügt dem angegebenen HtmlTextWriter und dem Webserver-Steuerelement die darzustellenden HTML-Attribute und -Stile hinzu. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von Style)
CopyFrom(Style)	Kopiert die Stileigenschaften des angegebenen Style-Objekts in die aktuelle Instanz der MenuItemStyle-Klasse.
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom Component verwendeten Ressourcen frei. (Geerbt von Component)
Dispose(Boolean)	Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von Component)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FillStyleAttributes(CssStyleCollection, IUrlResolutionService)	Fügt einem CssStyleCollection-Objekt die Stileigenschaften des angegebenen Objekts hinzu. (Geerbt von Style)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetService(Type)	Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component)
GetStyleAttributes(IUrlResolutionService)	Ruft das CssStyleCollection-Objekt für das angegebene, von IUrlResolutionService implementierte Objekt ab. (Geerbt von Style)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
LoadViewState(Object)	Lädt den zuvor gespeicherten Zustand. (Geerbt von Style)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
MergeWith(Style)	Kombiniert die Stileigenschaften des angegebenen Style-Objekts mit denen der aktuellen Instanz der MenuItemStyle-Klasse.
Reset()	Setzt die aktuelle Instanz der MenuItemStyle-Klasse auf ihren Ursprungszustand zurück.
SaveViewState()	Eine geschützte Methode. Speichert jeden Zustand, der nach dem Aufruf der TrackViewState()-Methode geändert wurde. (Geerbt von Style)
SetBit(Int32)	Eine geschützte interne Methode. Legt ein internes Bitmaskenfeld fest, das die in der Datenauflistung gespeicherten Stileigenschaften angibt. (Geerbt von Style)
SetDirty()	Markiert den Style, damit sein Zustand im Ansichtszustand aufgezeichnet wird. (Geerbt von Style)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Style)
TrackViewState()	Eine geschützte Methode. Markiert den Beginn der Verfolgung von Zustandsänderungen für das Steuerelement. Alle Änderungen nach Beginn der Nachverfolgung werden nachverfolgt und als Teil des Ansichtszustands des Steuerelements gespeichert. (Geerbt von Style)

Ereignisse

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.

(Geerbt von Component)

Explizite Schnittstellenimplementierungen

IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob ein Serversteuerelement Änderungen des Ansichtszustands nachverfolgt. (Geerbt von Style)
IStateManager.LoadViewState(Object)	Lädt den zuvor gespeicherten Zustand. (Geerbt von Style)
IStateManager.SaveViewState()	Gibt das Objekt zurück, das Zustandsänderungen enthält. (Geerbt von Style)
IStateManager.TrackViewState()	Startet das Verfolgen von Zustandsänderungen. (Geerbt von Style)

Gilt für: