TreeNodeBinding.ImageToolTip 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 il testo della descrizione comando per l'immagine visualizzata accanto a un nodo a cui viene applicato l'oggetto TreeNodeBinding .
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 StringValore della proprietà
Testo della descrizione comando per l'immagine visualizzata accanto a un nodo a cui viene applicato l'oggetto TreeNodeBinding . Il valore predefinito è una stringa vuota (""), che indica che la proprietà P:System.Web.UI.WebControls.TreeNodeBinding.ImageToolTip non è impostata.
Esempio
Questa sezione contiene due esempi di codice. Il primo esempio di codice illustra come utilizzare la ImageToolTip proprietà per specificare il testo della descrizione comando per l'immagine visualizzata accanto a un nodo a cui viene applicato l'oggetto TreeNodeBinding . Il secondo esempio di codice fornisce dati XML di esempio per il primo esempio di codice.
Nell'esempio seguente viene illustrato come utilizzare la ImageToolTip proprietà per specificare il testo della descrizione comando per l'immagine visualizzata accanto a un nodo a cui viene applicato l'oggetto TreeNodeBinding . Affinché questo esempio funzioni correttamente, è necessario copiare i dati XML di esempio, forniti dopo questo esempio di codice, in un file denominato 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>
Nell'esempio di codice seguente vengono forniti dati XML di esempio per l'esempio di codice precedente.
<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>
Commenti
Quando il TreeView controllo è associato a un'origine dati, utilizzare la ImageToolTip proprietà per specificare il valore da associare alla ImageToolTip proprietà di un TreeNode oggetto . Il testo specificato fornisce ai dispositivi Assistive Technology una descrizione dell'immagine che può essere usata per rendere il controllo più accessibile.
Questa relazione di associazione influisce su tutti gli TreeNode oggetti a cui viene applicato l'oggetto TreeNodeBinding . Quando un'immagine viene visualizzata accanto a un nodo, il testo della descrizione comando viene visualizzato quando il puntatore del mouse viene posizionato sull'immagine.
Annotazioni
È possibile eseguire l'override selettiva della ImageToolTip proprietà impostando direttamente la ImageToolTip proprietà di ogni nodo.
Anziché usare la ImageToolTip proprietà per associare lo stesso testo della descrizione comando a ogni immagine del nodo, è possibile associare la ImageToolTip proprietà di un TreeNode oggetto a un campo di un'origine dati impostando la ImageToolTipField proprietà .
Il valore di questa proprietà viene archiviato nello stato di visualizzazione.
Il valore di questa proprietà, se impostato, può essere salvato automaticamente in un file di risorse usando uno strumento di progettazione. Per altre informazioni, vedere LocalizableAttribute Globalizzazione e localizzazione.
