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 di descrizione comandi di un'immagine visualizzata accanto a un nodo a cui è 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 di descrizione comandi di un'immagine visualizzata accanto a un nodo a cui è 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
In questa sezione sono riportati due esempi di codice. Il primo esempio di codice illustra come usare la proprietà per specificare il ImageToolTip 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 usare la proprietà per specificare il ImageToolTip testo Della descrizione comando per l'immagine visualizzata accanto a un nodo a cui viene applicato l'oggetto TreeNodeBinding . Per il corretto funzionamento di questo esempio, è 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 controllo è associato a un'origine dati, utilizzare la TreeView ImageToolTip proprietà per specificare il valore da associare alla ImageToolTip proprietà di un TreeNode oggetto. Il testo specificato fornisce dispositivi Assistive Technology con 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 Descrizione comando viene visualizzato quando il puntatore del mouse viene posizionato sull'immagine.
Nota
È possibile eseguire l'override selettiva della proprietà impostando direttamente la ImageToolTip 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 proprietà di un oggetto a un campo di un'origine TreeNode dati impostando la ImageToolTip ImageToolTipField proprietà .
Il valore di questa proprietà viene archiviato nello stato di visualizzazione.
Il valore di questa proprietà, quando impostato, può essere salvato automaticamente in un file di risorse usando uno strumento di progettazione. Per altre informazioni, vedere LocalizableAttribute e Globalizzazione e Localizzazione.