TreeNodeBinding.ImageToolTip Proprietà

Definizione

Ottiene o imposta il testo di descrizione comandi di un'immagine visualizzata accanto a un nodo a cui è applicato l'oggetto TreeNodeBinding.Gets or sets the ToolTip text for the image that is displayed next to a node to which the TreeNodeBinding object is applied.

public:
 property System::String ^ ImageToolTip { System::String ^ get(); void set(System::String ^ value); };
public string ImageToolTip { get; set; }
member this.ImageToolTip : string with get, set
Public Property ImageToolTip As String

Valore della proprietà

String

Testo di descrizione comandi di un'immagine visualizzata accanto a un nodo a cui è applicato l'oggetto TreeNodeBinding.The ToolTip text for the image that is displayed next to a node to which the TreeNodeBinding object is applied. Il valore predefinito è una stringa vuota (""), che indica che la proprietà P:System.Web.UI.WebControls.TreeNodeBinding.ImageToolTip non è impostata.The default is an empty string (""), which indicates that the P:System.Web.UI.WebControls.TreeNodeBinding.ImageToolTip property is not set.

Esempio

In questa sezione sono riportati due esempi di codice.This section contains two code examples. Nel primo esempio di codice viene illustrato come utilizzare la ImageToolTip proprietà per specificare il testo della descrizione comando per l'immagine visualizzata accanto a un nodo a cui TreeNodeBinding è applicato l'oggetto.The first code example demonstrates how to use the ImageToolTip property to specify the ToolTip text for the image that is displayed next to a node to which the TreeNodeBinding object is applied. Il secondo esempio di codice fornisce dati XML di esempio per il primo esempio di codice.The second code example provides sample XML data for the first code example.

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 TreeNodeBinding è applicato l'oggetto.The following example demonstrates how to use the ImageToolTip property to specify the ToolTip text for the image that is displayed next to a node to which the TreeNodeBinding object is applied. 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.For this example to work correctly, you must copy the sample XML data, provided after this code example, to a file named 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 riportato di seguito vengono forniti dati XML di esempio per l'esempio di codice precedente.The following code example provides sample XML data for the preceding code example.

<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.When the TreeView control is bound to a data source, use the ImageToolTip property to specify the value to bind to the ImageToolTip property of a TreeNode object. Il testo specificato fornisce ai dispositivi di Assistive Technology una descrizione dell'immagine che può essere utilizzata per rendere il controllo più accessibile.The text that you specify provides Assistive Technology devices with a description of the image that can be used to make the control more accessible.

Questa relazione TreeNode di associazione ha effetto su tutti gli oggetti a cui TreeNodeBinding è applicato l'oggetto.This binding relationship affects all TreeNode objects to which the TreeNodeBinding object is applied. 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.When an image is displayed next to a node, the ToolTip text is displayed when the mouse pointer is positioned over the image.

Nota

È possibile eseguire l'override in modo selettivo della proprietà impostando ImageToolTip ImageToolTip direttamente la proprietà di ciascun nodo.You can selectively override the ImageToolTip property by setting the ImageToolTip property of each node directly.

Anziché utilizzare 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à.Instead of using the ImageToolTip property to bind the same ToolTip text to each node image, you can bind the ImageToolTip property of a TreeNode object to a field of a data source by setting the ImageToolTipField property.

Il valore di questa proprietà viene archiviato nello stato di visualizzazione.The value of this property is stored in view state.

Il valore di questa proprietà, se impostato, può essere salvato automaticamente in un file di risorse tramite uno strumento di progettazione.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Per ulteriori informazioni, vedere LocalizableAttribute e globalizzazione e localizzazione.For more information, see LocalizableAttribute and Globalization and Localization.

Si applica a

Vedi anche