MenuItemBinding.ToolTip Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece el texto de información sobre herramientas que se muestra en el elemento de menú al que se aplica el objeto MenuItemBinding.
public:
property System::String ^ ToolTip { System::String ^ get(); void set(System::String ^ value); };public string ToolTip { get; set; }member this.ToolTip : string with get, setPublic Property ToolTip As StringValor de propiedad
Texto de información sobre herramientas que se muestra en el elemento de menú al que se aplica el objeto MenuItemBinding. El valor predeterminado es una cadena vacía (""), lo que indica que no se ha establecido esta propiedad.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la ToolTip propiedad para especificar la información sobre herramientas que se va a mostrar cuando el usuario coloca el puntero del mouse sobre un elemento de menú. Esta información sobre herramientas se muestra para cada elemento de menú al que se aplica el MenuItemBinding objeto. Para que este ejemplo funcione correctamente, debe copiar los datos XML de ejemplo siguientes en un archivo denominado Menu.xml.
<%@ 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>MenuItemBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemBinding Example</h3>
<asp:menu id="NavigationMenu"
datasourceid="MenuSource"
runat="server">
<databindings>
<asp:menuitembinding datamember="MapHomeNode"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"/>
<asp:menuitembinding datamember="MapNode"
depth="1"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
text="Static Title"
value="Static Description"
imageurl="~\Images\StaticImage.jpg"
tooltip="Static ToolTip"/>
</databindings>
</asp:menu>
<asp:xmldatasource id="MenuSource"
datafile="Menu.xml"
runat="server"/>
</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>MenuItemBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItemBinding Example</h3>
<asp:menu id="NavigationMenu"
datasourceid="MenuSource"
runat="server">
<databindings>
<asp:menuitembinding datamember="MapHomeNode"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"/>
<asp:menuitembinding datamember="MapNode"
depth="1"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
text="Static Title"
value="Static Description"
imageurl="~\Images\StaticImage.jpg"
tooltip="Static ToolTip"/>
</databindings>
</asp:menu>
<asp:xmldatasource id="MenuSource"
datafile="Menu.xml"
runat="server"/>
</form>
</body>
</html>
El código siguiente es un ejemplo de datos de mapa del sitio para el ejemplo anterior.
<MapHomeNode ImageUrl="~\Images\Home.gif"
Title="Home"
Description="Root Page"
ToolTip="Home Page">
<MapNode ImageUrl="~\Images\Music.gif"
Title="Music"
Description="Music Category"
ToolTip="Music Page">
<MapNode ImageUrl="~\Images\Classical.gif"
Title="Classical"
Description="Classical Section"
ToolTip="Classical Page"/>
<MapNode ImageUrl="~\Images\Rock.gif"
Title="Rock"
Description="Rock Section"
ToolTip="Rock Page"/>
<MapNode ImageUrl="~\Images\Jazz.gif"
Title="Jazz"
Description="Jazz Section"
ToolTip="Jazz Page"/>
</MapNode>
<MapNode ImageUrl="~\Images\Movies.gif"
Title="Movies"
Description="Movies Category"
ToolTip="Movies Page">
<MapNode ImageUrl="~\Images\Action.gif"
Title="Action"
Description="Action Section"
ToolTip="Action Page"/>
<MapNode ImageUrl="~\Images\Drama.gif"
Title="Drama"
Description="Drama Section"
ToolTip="Drama Page"/>
<MapNode ImageUrl="~\Images\Musical.gif"
Title="Musical"
Description="Musical Section"
ToolTip="Musical Page"/>
</MapNode>
</MapHomeNode>
Comentarios
Cuando el Menu control se enlaza a un origen de datos, utilice la ToolTip propiedad para especificar el texto que se va a enlazar a la MenuItem.ToolTip propiedad de un MenuItem objeto . Esta información sobre herramientas se comparte con todos los elementos de menú a los que se aplica el MenuItemBinding objeto. Cuando el usuario coloca el puntero del mouse sobre un elemento de menú, se muestra el texto especificado.
Nota
Puede invalidar la información sobre herramientas de un elemento de menú individual estableciendo su ToolTip propiedad directamente.
En lugar de usar esta propiedad para especificar la misma información sobre herramientas para cada elemento de menú, también puede enlazar la ToolTip propiedad de un MenuItem objeto a un campo de un origen de datos estableciendo la ToolTipField propiedad . Cuando se representa, la ToolTip propiedad de cada elemento de menú al que se aplica el MenuItemBinding objeto contiene el valor correspondiente del campo.
Nota
Si se establecen las ToolTip propiedades y ToolTipField , la ToolTipField propiedad tiene prioridad.
El valor de esta propiedad, cuando se establece, se puede guardar automáticamente en un archivo de recursos mediante una herramienta de diseñador. Para obtener más información, vea LocalizableAttributeGlobalización y localización.
