MenuItem.PopOutImageUrl プロパティ

定義

メニュー項目に動的なサブメニューがあることを示すためにメニュー項目に表示されるイメージの URL を取得または設定します。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

プロパティ値

String

メニュー項目に動的なサブメニューがあることを示すためにメニュー項目に表示されるイメージの URL。The URL to an image that is displayed in a menu item to indicate that the menu item has a dynamic submenu. 既定値は空の文字列 ("") です。このプロパティが設定されていないことを示します。The default is an empty string (""), which indicates that this property is not set.

PopOutImageUrlメニュー項目に動的サブメニューがある場合に、プロパティを使用してメニュー項目に表示するカスタムイメージを指定する方法を次の例に示します。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>

注釈

がに設定されている場合、 System.Web.UI.WebControls.MenuRenderingMode または List がに設定され、 System.Web.UI.WebControls.MenuRenderingMode Default PagesSection.ControlRenderingCompatibilityVersion が以降に設定されている場合 4.0 、このプロパティは無効になります。If 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. Menu.DynamicEnableDefaultPopOutImageこのプロパティの代わりに、プロパティまたはプロパティを使用し Menu.StaticEnableDefaultPopOutImage ます。Use the Menu.DynamicEnableDefaultPopOutImage property or the Menu.StaticEnableDefaultPopOutImage property instead of this property.

がに設定されている場合、またはがに設定され System.Web.UI.WebControls.MenuRenderingMode Table System.Web.UI.WebControls.MenuRenderingMode Default ていてがに設定されている場合は PagesSection.ControlRenderingCompatibilityVersion 3.5 、このプロパティを使用してメニュー項目に表示されるカスタムイメージを指定し、メニュー項目に動的サブメニューがあることを示すことができます。If 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. このイメージは、クライアントのブラウザーがその形式をサポートしている限り、任意のファイル形式 (.jpg、.gif、.bmp など) にすることができます。This image can be in any file format (.jpg, .gif, .bmp, and so on), as long as the client's browser supports that format.

注意

このプロパティを設定すると、プロパティおよびプロパティによって指定されたイメージがオーバーライドされ Menu.DynamicPopOutImageUrl Menu.StaticPopOutImageUrl ます。Setting this property overrides the image specified by the Menu.DynamicPopOutImageUrl and Menu.StaticPopOutImageUrl properties.

このプロパティを空の文字列に設定し、プロパティをに設定することによって、静的メニューでこのイメージを無効にすることもでき StaticEnableDefaultPopOutImage false ます。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. 同様に、このプロパティを空の文字列に設定し、プロパティをに設定することによって、このイメージを動的メニューで無効にすることができます DynamicEnableDefaultPopOutImage falseSimilarly, you can disable this image in a dynamic menu by setting this property to an empty string and setting the DynamicEnableDefaultPopOutImage property to false.

適用対象

こちらもご覧ください