MenuItem.PopOutImageUrl Eigenschaft

Definition

Ruft die URL zu einem Bild ab oder legt eine URL zu einem Bild fest, das in einem Menüelement angezeigt wird und angibt, dass dieses Menüelement über ein dynamisches Untermenü verfügt.Gets or sets the URL to an image that is displayed in a menu item to indicate that the menu item has a dynamic submenu.

public:
 property System::String ^ PopOutImageUrl { System::String ^ get(); void set(System::String ^ value); };
public string PopOutImageUrl { get; set; }
member this.PopOutImageUrl : string with get, set
Public Property PopOutImageUrl As String

Eigenschaftswert

Die URL zu einem Bild, das in einem Menüelement angezeigt wird und angibt, dass dieses Menüelement über ein dynamisches Untermenü verfügt.The URL to an image that is displayed in a menu item to indicate that the menu item has a dynamic submenu. Der Standardwert ist eine leere Zeichenfolge ("") und gibt an, dass diese Eigenschaft nicht festgelegt ist.The default is an empty string (""), which indicates that this property is not set.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die PopOutImageUrl -Eigenschaft verwendet wird, um ein benutzerdefiniertes Bild anzugeben, das in einem Menü Element angezeigt wird, wenn das Menü Element über ein dynamisches Untermenü verfügt.The following example demonstrates how to use the PopOutImageUrl property to specify a custom image to display in a menu item when the menu item has a dynamic submenu.


<%@ 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" >
  <head runat="server">
    <title>MenuItem Declarative Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Declarative Example</h3>
    
      <!-- Use declarative syntax to create the   -->
      <!-- menu structure. Create submenu items   -->
      <!-- by nesting them within parent menu     -->
      <!-- items.                                 -->
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="1"
        staticsubmenuindent="10" 
        orientation="Vertical" 
        target="_blank"  
        runat="server">

        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            imageurl="Images\Home.gif"
            popoutimageurl="Images\Popout.jpg"   
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              popoutimageurl="Images\Popout.jpg"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              popoutimageurl="Images\Popout.jpg"              
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                separatorimageurl="Images\Separator.jpg"
                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" >
  <head runat="server">
    <title>MenuItem Declarative Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Declarative Example</h3>
    
      <!-- Use declarative syntax to create the   -->
      <!-- menu structure. Create submenu items   -->
      <!-- by nesting them within parent menu     -->
      <!-- items.                                 -->
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="1"
        staticsubmenuindent="10" 
        orientation="Vertical" 
        target="_blank"  
        runat="server">

        <items>
          <asp:menuitem navigateurl="Home.aspx" 
            text="Home"
            imageurl="Images\Home.gif"
            popoutimageurl="Images\Popout.jpg"   
            tooltip="Home">
            <asp:menuitem navigateurl="Music.aspx"
              text="Music"
              popoutimageurl="Images\Popout.jpg"
              tooltip="Music">
              <asp:menuitem navigateurl="Classical.aspx" 
                text="Classical"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Classical"/>
              <asp:menuitem navigateurl="Rock.aspx"
                text="Rock"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Rock"/>
              <asp:menuitem navigateurl="Jazz.aspx"
                text="Jazz"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem navigateurl="Movies.aspx"
              text="Movies"
              popoutimageurl="Images\Popout.jpg"              
              tooltip="Movies">
              <asp:menuitem navigateurl="Action.aspx"
                text="Action"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Action"/>
              <asp:menuitem navigateurl="Drama.aspx"
                text="Drama"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Drama"/>
              <asp:menuitem navigateurl="Musical.aspx"
                text="Musical"
                separatorimageurl="Images\Separator.jpg"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

    </form>
  </body>
</html>

Hinweise

Wenn System.Web.UI.WebControls.MenuRenderingMode auf Default System.Web.UI.WebControls.MenuRenderingMode PagesSection.ControlRenderingCompatibilityVersion 4.0 festgelegt ist, oder wenn auf und auf oder höher festgelegt ist, hat diese Eigenschaft keine Auswirkung. ListIf System.Web.UI.WebControls.MenuRenderingMode is set to List, or if System.Web.UI.WebControls.MenuRenderingMode is set to Default and PagesSection.ControlRenderingCompatibilityVersion is set to 4.0 or later, this property has no effect. Verwenden Sie Menu.DynamicEnableDefaultPopOutImage die-Eigenschaft Menu.StaticEnableDefaultPopOutImage oder die-Eigenschaft anstelle dieser Eigenschaft.Use the Menu.DynamicEnableDefaultPopOutImage property or the Menu.StaticEnableDefaultPopOutImage property instead of this property.

Wenn System.Web.UI.WebControls.MenuRenderingMode auf Default System.Web.UI.WebControls.MenuRenderingMode PagesSection.ControlRenderingCompatibilityVersion festgelegt ist, oder wenn auf und3.5auf festgelegt ist, verwenden Sie diese Eigenschaft, um ein benutzerdefiniertes Bild anzugeben, das in einem Menü Element angezeigt wird, um anzugeben, dass das Menü Element über ein dynamisches Untermenü verfügt. TableIf System.Web.UI.WebControls.MenuRenderingMode is set to Table, or if System.Web.UI.WebControls.MenuRenderingMode is set to Default and PagesSection.ControlRenderingCompatibilityVersion is set to 3.5, use this property to specify a custom image that is displayed in a menu item to indicate that the menu item has a dynamic submenu. Dieses Bild kann in einem beliebigen Dateiformat (JPG, GIF, BMP usw.) vorliegen, solange der Client Browser dieses Format unterstützt.This image can be in any file format (.jpg, .gif, .bmp, and so on), as long as the client's browser supports that format.

Hinweis

Durch Festlegen dieser Eigenschaft wird das von den Menu.DynamicPopOutImageUrl Eigenschaften und Menu.StaticPopOutImageUrl angegebene Bild überschrieben.Setting this property overrides the image specified by the Menu.DynamicPopOutImageUrl and Menu.StaticPopOutImageUrl properties.

Sie können dieses Bild auch in einem statischen Menü deaktivieren, indem Sie diese Eigenschaft auf eine leere Zeichenfolge festlegen StaticEnableDefaultPopOutImage und die false-Eigenschaft auf festlegen.You can also disable this image in a static menu by setting this property to an empty string and setting the StaticEnableDefaultPopOutImage property to false. Auf ähnliche Weise können Sie dieses Bild in einem dynamischen Menü deaktivieren, indem Sie diese Eigenschaft auf eine leere Zeichenfolge DynamicEnableDefaultPopOutImage festlegen und falsedie-Eigenschaft auf festlegen.Similarly, you can disable this image in a dynamic menu by setting this property to an empty string and setting the DynamicEnableDefaultPopOutImage property to false.

Gilt für:

Siehe auch