MenuItem.PopOutImageUrl プロパティ

定義

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

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

プロパティ値

メニュー項目に動的なサブメニューがあることを示すためにメニュー項目に表示されるイメージの URL。 既定値は空の文字列 ("") です。このプロパティが設定されていないことを示します。

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


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

注釈

が にList設定されている場合System.Web.UI.WebControls.MenuRenderingMode、または が にDefault設定されPagesSection.ControlRenderingCompatibilityVersion、 が 以降に4.0設定されている場合System.Web.UI.WebControls.MenuRenderingMode、このプロパティは無効です。 このプロパティの Menu.DynamicEnableDefaultPopOutImage 代わりに、 プロパティまたは プロパティを Menu.StaticEnableDefaultPopOutImage 使用します。

が にTable設定されている場合System.Web.UI.WebControls.MenuRenderingMode、または が に設定されPagesSection.ControlRenderingCompatibilityVersionDefault が に3.5設定されている場合System.Web.UI.WebControls.MenuRenderingModeは、このプロパティを使用して、メニュー項目に表示されるカスタム イメージを指定して、メニュー項目に動的サブメニューがあることを示します。 このイメージは、クライアントのブラウザーがその形式をサポートしている限り、任意のファイル形式 (.jpg、.gif、.bmpなど) にすることができます。

注意

このプロパティを設定すると、 プロパティと Menu.StaticPopOutImageUrl プロパティで指定されたイメージがMenu.DynamicPopOutImageUrlオーバーライドされます。

このプロパティを空の文字列に設定し、 プロパティを に設定することで、静的メニューでこのイメージをStaticEnableDefaultPopOutImagefalse無効にすることもできます。 同様に、動的メニューでこのイメージを無効にするには、このプロパティを空の文字列に設定し、 プロパティを DynamicEnableDefaultPopOutImagefalse設定します。

適用対象

こちらもご覧ください