MenuItemStyle Classe

Définition

Représente le style d’un élément de menu dans un contrôle Menu. Cette classe ne peut pas être héritée.

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
Héritage

Exemples

L’exemple de code suivant montre comment contrôler l’apparence des éléments de menu dans un Menu contrôle en définissant les propriétés de style de l’objet MenuItemStyle retourné par les DynamicMenuItemStylepropriétés , DynamicHoverStyle, StaticMenuItemStyleet 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>

Remarques

Utilisez la MenuItemStyle classe pour représenter le style d’un élément de menu dans le Menu contrôle . Un élément de menu s’affiche dans un menu statique ou dynamique. Un menu statique est toujours affiché dans un Menu contrôle, tandis qu’un menu dynamique s’affiche uniquement lorsque l’utilisateur positionne le pointeur de la souris sur un élément de menu parent qui contient un sous-menu dynamique. Vous pouvez spécifier différentes caractéristiques de style (telles que la taille et la couleur de police) pour chacun des différents types d’éléments de menu. Le tableau suivant répertorie les styles d’éléments de menu disponibles.

Propriété de style d’élément de menu Description
DynamicHoverStyle Paramètres de style pour un élément de menu dynamique lorsque le pointeur de la souris est positionné sur celui-ci.
DynamicMenuItemStyle Paramètres de style pour un élément de menu dynamique individuel.
DynamicMenuStyle Paramètres de style d’un menu dynamique.
DynamicSelectedStyle Paramètres de style pour l’élément de menu dynamique actuellement sélectionné.
StaticHoverStyle Paramètres de style d’un élément de menu statique lorsque le pointeur de la souris est positionné sur celui-ci.
StaticMenuItemStyle Paramètres de style pour un élément de menu statique individuel.
StaticMenuStyle Paramètres de style d’un menu statique.
StaticSelectedStyle Paramètres de style pour l’élément de menu statique actuellement sélectionné.

Lorsque plusieurs propriétés de style sont définies pour un élément de menu statique, les propriétés de style sont appliquées dans l’ordre suivant :

  1. StaticMenuStyle.

  2. StaticMenuItemStyle. Si la collection ou LevelSubMenuStyles la LevelMenuItemStyles collection est définie, elle est appliquée à ce stade, en remplaçant les autres propriétés de style d’élément de menu.

  3. StaticSelectedStyle. Si la LevelSelectedStyles collection est définie, elle est appliquée à ce stade, en remplaçant les autres propriétés de style d’élément de menu.

  4. StaticHoverStyle.

De même, les propriétés de style d’un élément de menu dynamique sont appliquées dans l’ordre suivant :

  1. DynamicMenuStyle.

  2. DynamicMenuItemStyle. Si la collection ou LevelSubMenuStyles la LevelMenuItemStyles collection est définie, elle est appliquée à ce stade, en remplaçant les autres propriétés de style d’élément de menu.

  3. DynamicSelectedStyle. Si la LevelSelectedStyles collection est définie, elle est appliquée à ce stade, en remplaçant les autres propriétés de style d’élément de menu.

  4. DynamicHoverStyle.

La MenuItemStyle classe hérite de la plupart de ses membres de la Style classe . Il étend la Style classe en fournissant des propriétés qui contrôlent la quantité d’espace autour du texte d’un élément de menu, ainsi que l’espace entre les éléments de menu adjacents. Utilisez la HorizontalPadding propriété pour contrôler la quantité d’espace à gauche et à droite du texte de l’élément de menu. De même, la VerticalPadding propriété contrôle la quantité d’espace au-dessus et en dessous du texte de l’élément de menu. Vous pouvez contrôler la quantité d’espacement entre l’élément de menu auquel l’objet MenuItemStyle est appliqué et ses éléments de menu adjacents en définissant la ItemSpacing propriété .

Pour plus d’informations sur les paramètres de style hérités, consultez Style.

Constructeurs

MenuItemStyle()

Initialise une nouvelle instance de la classe MenuItemStyle.

MenuItemStyle(StateBag)

Initialise une nouvelle instance de la classe MenuItemStyle avec les informations d'état spécifiées.

Propriétés

BackColor

Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web.

(Hérité de Style)
BorderColor

Obtient ou définit la couleur de bordure du contrôle serveur Web.

(Hérité de Style)
BorderStyle

Obtient ou définit le style de bordure du contrôle serveur Web.

(Hérité de Style)
BorderWidth

Obtient ou définit la largeur de bordure du contrôle serveur Web.

(Hérité de Style)
CanRaiseEvents

Obtient une valeur qui indique si le composant peut déclencher un événement.

(Hérité de Component)
Container

Obtient le IContainer qui contient la Component.

(Hérité de Component)
CssClass

Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client.

(Hérité de Style)
DesignMode

Obtient une valeur qui indique si Component est actuellement en mode design.

(Hérité de Component)
Events

Obtient la liste des gestionnaires d'événements attachés à ce Component.

(Hérité de Component)
Font

Obtient les propriétés de police associées au contrôle serveur Web.

(Hérité de Style)
ForeColor

Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web.

(Hérité de Style)
Height

Obtient ou définit la hauteur du contrôle serveur Web.

(Hérité de Style)
HorizontalPadding

Obtient ou définit l'espace à gauche et droit du texte de l'élément de menu.

IsEmpty

Propriété protégée. Récupère une valeur indiquant si des éléments de style ont été définis dans le sac d'états.

(Hérité de Style)
IsTrackingViewState

Retourne une valeur indiquant si des éléments de style ont été définis dans le sac d'états.

(Hérité de Style)
ItemSpacing

Obtient ou définit l'espacement vertical entre l'élément de menu auquel l'objet MenuItemStyle est appliqué et ses éléments de menu adjacents.

RegisteredCssClass

Obtient la classe de feuille de style en cascade (CSS, Cascading Style Sheet) qui est enregistrée avec le contrôle.

(Hérité de Style)
Site

Obtient ou définit le ISite de Component.

(Hérité de Component)
VerticalPadding

Obtient ou définit l'espace au-dessus et en dessous du texte d'un élément de menu.

ViewState

Obtient le sac d'états qui contient les éléments de style.

(Hérité de Style)
Width

Obtient ou définit la largeur du contrôle serveur web.

(Hérité de Style)

Méthodes

AddAttributesToRender(HtmlTextWriter)

Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriter spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de Style)
AddAttributesToRender(HtmlTextWriter, WebControl)

Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriter et au contrôle serveur Web spécifiés. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de Style)
CopyFrom(Style)

Copie les propriétés de style de l'objet Style spécifié dans l'instance actuelle de la classe MenuItemStyle.

CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.

(Hérité de MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par Component.

(Hérité de Component)
Dispose(Boolean)

Libère les ressources non managées utilisées par Component et libère éventuellement les ressources managées.

(Hérité de Component)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
FillStyleAttributes(CssStyleCollection, IUrlResolutionService)

Ajoute les propriétés de style de l'objet spécifié à un objet CssStyleCollection.

(Hérité de Style)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetLifetimeService()
Obsolète.

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
GetService(Type)

Retourne un objet qui représente un service fourni par Component ou par son Container.

(Hérité de Component)
GetStyleAttributes(IUrlResolutionService)

Récupère l'objet CssStyleCollection pour l'objet implémentant IUrlResolutionService spécifié.

(Hérité de Style)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
InitializeLifetimeService()
Obsolète.

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
LoadViewState(Object)

Charge l'état enregistré précédemment.

(Hérité de Style)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.

(Hérité de MarshalByRefObject)
MergeWith(Style)

Combine les propriétés de style de l'objet Style spécifié avec celles de l'instance actuelle de la classe MenuItemStyle.

Reset()

Restaure l'état d'origine de l'instance actuelle de la classe MenuItemStyle.

SaveViewState()

Méthode protégée. Enregistre les états qui ont été modifiés après l'appel de la méthode TrackViewState().

(Hérité de Style)
SetBit(Int32)

Méthode interne protégée. Définit un champ de masque de bits interne qui indique les propriétés de style stockées dans le sac d'états.

(Hérité de Style)
SetDirty()

Marque le Style afin que son état soit enregistré dans l'état d'affichage.

(Hérité de Style)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Style)
TrackViewState()

Méthode protégée. Marque le début du suivi des modifications d'état sur le contrôle. Toutes les modifications effectuées une fois que le traçage a commencé seront suivies et enregistrées dans le cadre de l'état d'affichage du contrôle.

(Hérité de Style)

Événements

Disposed

Se produit lorsque le composant est supprimé par un appel à la méthode Dispose().

(Hérité de Component)

Implémentations d’interfaces explicites

IStateManager.IsTrackingViewState

Obtient une valeur qui indique si un contrôle serveur effectue le suivi des modifications apportées à son état d'affichage.

(Hérité de Style)
IStateManager.LoadViewState(Object)

Charge l'état enregistré précédemment.

(Hérité de Style)
IStateManager.SaveViewState()

Retourne l'objet contenant les modifications de l'état.

(Hérité de Style)
IStateManager.TrackViewState()

Commence à suivre les modifications d'état.

(Hérité de Style)

S’applique à

Voir aussi