MenuItem.PopOutImageUrl Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta l'URL di un'immagine visualizzata in una voce di menu per indicare che la voce di menu dispone di un sottomenu dinamico.
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
Valore della proprietà
URL di un'immagine visualizzata in una voce di menu per indicare che la voce di menu dispone di un sottomenu dinamico. Il valore predefinito è una stringa vuota (""), a indicare che questa proprietà non è impostata.
Esempio
Nell'esempio seguente viene illustrato come usare la PopOutImageUrl proprietà per specificare un'immagine personalizzata da visualizzare in una voce di menu quando la voce di menu ha un sottomenu dinamico.
<%@ 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>
Commenti
Se System.Web.UI.WebControls.MenuRenderingMode è impostato su List
o se System.Web.UI.WebControls.MenuRenderingMode è impostato su e PagesSection.ControlRenderingCompatibilityVersion viene impostato Default
su 4.0
o versioni successive, questa proprietà non ha alcun effetto. Utilizzare la proprietà o la Menu.DynamicEnableDefaultPopOutImageMenu.StaticEnableDefaultPopOutImage proprietà anziché questa proprietà.
Se System.Web.UI.WebControls.MenuRenderingMode è impostato su Table
o se System.Web.UI.WebControls.MenuRenderingMode è impostato Default
su 3.5
e PagesSection.ControlRenderingCompatibilityVersion viene impostato su , utilizzare questa proprietà per specificare un'immagine personalizzata visualizzata in una voce di menu per indicare che la voce di menu ha un sottomenu dinamico. Questa immagine può essere in qualsiasi formato di file (.jpg, .gif, .bmp e così via), purché il browser del client supporti tale formato.
Nota
L'impostazione di questa proprietà esegue l'override dell'immagine specificata dalle Menu.DynamicPopOutImageUrl proprietà e Menu.StaticPopOutImageUrl .
È anche possibile disabilitare questa immagine in un menu statico impostando questa proprietà su una stringa vuota e impostando la StaticEnableDefaultPopOutImage proprietà su false
. Analogamente, è possibile disabilitare questa immagine in un menu dinamico impostando questa proprietà su una stringa vuota e impostando la DynamicEnableDefaultPopOutImage proprietà su false
.