TreeNodeBinding.ImageToolTip Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den QuickInfo-Text für das Bild ab, das neben einem Knoten angezeigt wird, auf den das TreeNodeBinding-Objekt angewendet wird, oder legt diesen Text fest.

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

Eigenschaftswert

String

Der QuickInfo-Text für das Bild, das neben einem Knoten angezeigt wird, auf den das TreeNodeBinding-Objekt angewendet wird. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass die P:System.Web.UI.WebControls.TreeNodeBinding.ImageToolTip-Eigenschaft nicht festgelegt wurde.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie die ImageToolTip -Eigenschaft verwendet wird, um den QuickInfo-Text für das Bild anzugeben, der neben einem Knoten angezeigt wird, auf den das TreeNodeBinding Objekt angewendet wird. Das zweite Codebeispiel enthält XML-Beispieldaten für das erste Codebeispiel.

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe der ImageToolTip -Eigenschaft den QuickInfo-Text für das Bild angeben, der neben einem Knoten angezeigt wird, auf den das TreeNodeBinding Objekt angewendet wird. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die XML-Beispieldaten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei mit dem Namen Booklist.xml kopieren.


<%@ 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>

Im folgenden Codebeispiel werden XML-Beispieldaten für das vorherige Codebeispiel bereitgestellt.

<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>

Hinweise

Wenn das TreeView Steuerelement an eine Datenquelle gebunden ist, verwenden Sie die ImageToolTip -Eigenschaft, um den Wert anzugeben, der an die ImageToolTip Eigenschaft eines TreeNode Objekts gebunden werden soll. Der von Ihnen angegebene Text enthält Assistive Technology-Geräte mit einer Beschreibung des Bilds, mit dem das Steuerelement leichter zugänglich werden kann.

Diese Bindungsbeziehung wirkt sich auf alle TreeNode Objekte aus, auf die das TreeNodeBinding Objekt angewendet wird. Wenn ein Bild neben einem Knoten angezeigt wird, wird der QuickInfo-Text angezeigt, wenn der Mauszeiger über dem Bild positioniert wird.

Hinweis

Sie können die ImageToolTip Eigenschaft selektiv überschreiben, indem Sie die ImageToolTip Eigenschaft jedes Knotens direkt festlegen.

Anstatt die ImageToolTip -Eigenschaft zu verwenden, um denselben QuickInfo-Text an jedes Knotenbild zu binden, können Sie die ImageToolTip Eigenschaft eines TreeNode Objekts an ein Feld einer Datenquelle binden, indem Sie die ImageToolTipField -Eigenschaft festlegen.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Der Wert dieser Eigenschaft, wenn festgelegt, kann mithilfe eines Designers Tools automatisch zu einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und Globalisierung und Lokalisierung.

Gilt für:

Freigeben über