TreeNodeBinding.ImageToolTip 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 o texto ToolTip para a imagem que é exibida ao lado de um nó ao qual o TreeNodeBinding objeto é aplicado.
public:
property System::String ^ ImageToolTip { System::String ^ get(); void set(System::String ^ value); };public string ImageToolTip { get; set; }member this.ImageToolTip : string with get, setPublic Property ImageToolTip As StringValor de Propriedade
O texto ToolTip para a imagem que é exibida ao lado de um nó ao qual o TreeNodeBinding objeto é aplicado. O padrão é uma string vazia (""), o que indica que a propriedade P:System.Web.UI.WebControls.TreeNodeBinding.ImageToolTip, não está definida.
Exemplos
Esta seção contém dois exemplos de código. O primeiro exemplo de código demonstra como usar a ImageToolTip propriedade para especificar o texto ToolTip para a imagem que é exibida ao lado de um nó ao qual o TreeNodeBinding objeto é aplicado. O segundo exemplo de código fornece dados XML de exemplo para o primeiro exemplo de código.
O exemplo seguinte demonstra como usar a ImageToolTip propriedade para especificar o texto ToolTip para a imagem que é exibida ao lado de um nó ao qual o TreeNodeBinding objeto é aplicado. Para que este exemplo funcione corretamente, deve copiar os dados XML de amostra, fornecidos após este exemplo de código, para um ficheiro chamado Booklist.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>TreeViewBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeViewBinding Example</h3>
<!-- Set the Text, ImageUrl, ImageToolTip, -->
<!-- NavigateUrl, Value, and ToolTip -->
<!-- properties of a TreeNodeBinding -->
<!-- object declaratively. -->
<asp:TreeView id="BookTreeView"
DataSourceID="BookXmlDataSource"
Target="_blank"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Books"
Depth="0"
TextField="Text"/>
<asp:TreeNodeBinding DataMember="Book"
Depth="1"
Text="Book Title"
ImageUrl="Image.jpg"
ImageToolTip="Book Image"
NavigateUrl="http://www.microsoft.com"
Value="BookID"
ToolTip="Book Information"/>
<asp:TreeNodeBinding DataMember="Description"
Depth="2"
TextField="Text"/>
<asp:TreeNodeBinding DataMember="Price"
Depth="2"
TextField="Value"/>
</DataBindings>
</asp:TreeView>
<asp:XmlDataSource id="BookXmlDataSource"
DataFile="Booklist.xml"
runat="server">
</asp:XmlDataSource>
</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>TreeViewBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeViewBinding Example</h3>
<!-- Set the Text, ImageUrl, ImageToolTip, -->
<!-- NavigateUrl, Value, and ToolTip -->
<!-- properties of a TreeNodeBinding -->
<!-- object declaratively. -->
<asp:TreeView id="BookTreeView"
DataSourceID="BookXmlDataSource"
Target="_blank"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Books"
Depth="0"
TextField="Text"/>
<asp:TreeNodeBinding DataMember="Book"
Depth="1"
Text="Book Title"
ImageUrl="Image.jpg"
ImageToolTip="Book Image"
NavigateUrl="http://www.microsoft.com"
Value="BookID"
ToolTip="Book Information"/>
<asp:TreeNodeBinding DataMember="Description"
Depth="2"
TextField="Text"/>
<asp:TreeNodeBinding DataMember="Price"
Depth="2"
TextField="Value"/>
</DataBindings>
</asp:TreeView>
<asp:XmlDataSource id="BookXmlDataSource"
DataFile="Booklist.xml"
runat="server">
</asp:XmlDataSource>
</form>
</body>
</html>
O exemplo de código seguinte fornece dados XML de exemplo para o exemplo de código anterior.
<Books Text="Books List">
<Book Text="Book Title One"
Value="1"
Image="Bookimage1.jpg"
ImageToolTip="Book 1 Photo"
Nav="http://www.microsoft.com"
Tip="Book Title 1">
<Description Text="Book Description">
</Description>
<Price Value="$1.99">
</Price>
<Author Text="Author Name"
Value="LastName"
Image="Authorimage1.jpg"
Nav="http://www.microsoft.com"
Tip="Author Name">
</Author>
</Book>
<Book Text="Book Title Two"
Value="2"
Image="Bookimage2.jpg"
ImageToolTip="Book 2 Photo"
Nav="http://www.microsoft.com"
Tip="Click Me">
<Description Text="Book Description">
</Description>
<Price Value="$2.99">
</Price>
<Author Text="Author Name"
Value="LastName"
Image="Authorimage2.jpg"
Nav="http://www.microsoft.com"
Tip="Author Name">
</Author>
</Book>
</Books>
Observações
Quando o controlo TreeView está ligado a uma fonte de dados, use a ImageToolTip propriedade para especificar o valor a vincular à ImageToolTip propriedade de um TreeNode objeto. O texto que especifica fornece aos dispositivos de Tecnologia Assistiva uma descrição da imagem que pode ser usada para tornar o controlo mais acessível.
Esta relação de ligação afeta todos os TreeNode objetos a que o TreeNodeBinding objeto é aplicado. Quando uma imagem é exibida ao lado de um nó, o texto da ToolTip é mostrado quando o ponteiro do rato está posicionado sobre a imagem.
Note
Podes substituir seletivamente a ImageToolTip propriedade definindo a ImageToolTip propriedade de cada nó diretamente.
Em vez de usar a ImageToolTip propriedade para associar o mesmo texto ToolTip a cada imagem de nó, pode associar a ImageToolTip propriedade de um TreeNode objeto a um campo de uma fonte de dados definindo a ImageToolTipField propriedade.
O valor desta propriedade é armazenado no estado de visualização.
O valor desta propriedade, quando definido, pode ser guardado automaticamente num ficheiro de recurso usando uma ferramenta de design. Para mais informações, veja LocalizableAttributeGlobalização e Localização.