MenuItem.PopOutImageUrl Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define a URL para uma imagem que é exibida num item do menu para indicar que o item do menu tem um submenu dinâmico.
public:
property System::String ^ PopOutImageUrl { System::String ^ get(); void set(System::String ^ value); };public string PopOutImageUrl { get; set; }member this.PopOutImageUrl : string with get, setPublic Property PopOutImageUrl As StringValor de Propriedade
O URL de uma imagem que é exibido num item do menu indica que o item do menu tem um submenu dinâmico. O padrão é uma cadeia vazia (""), o que indica que esta propriedade não está definida.
Exemplos
O exemplo seguinte demonstra como usar a PopOutImageUrl propriedade para especificar uma imagem personalizada a ser exibida num item do menu quando o item do menu tem um submenu dinâmico.
<%@ 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>
Observações
Se System.Web.UI.WebControls.MenuRenderingMode for definido como List, ou se System.Web.UI.WebControls.MenuRenderingMode for definido como Default e PagesSection.ControlRenderingCompatibilityVersion for definido como 4.0 ou posterior, esta propriedade não tem efeito. Use a Menu.DynamicEnableDefaultPopOutImage propriedade ou a Menu.StaticEnableDefaultPopOutImage propriedade em vez desta propriedade.
Se System.Web.UI.WebControls.MenuRenderingMode estiver definido como Table, ou se System.Web.UI.WebControls.MenuRenderingMode estiver definido como Default e PagesSection.ControlRenderingCompatibilityVersion definido como 3.5, use esta propriedade para especificar uma imagem personalizada que é exibida num elemento do menu para indicar que o elemento do menu tem um submenu dinâmico. Esta imagem pode estar em qualquer formato de ficheiro (.jpg, .gif, .bmp, etc.), desde que o navegador do cliente suporte esse formato.
Note
Definir esta propriedade sobrepõe a imagem especificada pelas Menu.DynamicPopOutImageUrl propriedades e Menu.StaticPopOutImageUrl .
Também pode desativar esta imagem num menu estático, definindo esta propriedade para uma string vazia e definindo a StaticEnableDefaultPopOutImage propriedade para false. De forma semelhante, pode desativar esta imagem num menu dinâmico definindo esta propriedade para uma cadeia vazia e definindo a DynamicEnableDefaultPopOutImage propriedade para false.
