TreeNodeBinding.ToolTip Eigenschaft
Definition
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 einen Knoten ab, auf den das TreeNodeBinding-Objekt angewendet wird, oder legt diesen Text fest.
public:
property System::String ^ ToolTip { System::String ^ get(); void set(System::String ^ value); };public string ToolTip { get; set; }member this.ToolTip : string with get, setPublic Property ToolTip As StringEigenschaftswert
Der QuickInfo-Text für einen Knoten, auf den das TreeNodeBinding-Objekt angewendet wird. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass die ToolTip-Eigenschaft nicht festgelegt ist.
Beispiele
Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie Sie die ToolTip Eigenschaft verwenden, um den QuickInfo-Text für einen Knoten anzugeben, auf den das TreeNodeBinding Objekt angewendet wird. Im zweiten Codebeispiel werden Beispiel-XML-Daten für das erste Codebeispiel bereitgestellt.
Im folgenden Beispiel wird veranschaulicht, wie Sie die ToolTip Eigenschaft verwenden, um den QuickInfo-Text für einen Knoten anzugeben, auf den das TreeNodeBinding Objekt angewendet wird. In diesem Beispiel müssen Sie die Beispiel-XML-Daten, die nach diesem Codebeispiel angegeben sind, 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 Beispiel-XML-Daten 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 ToolTip Eigenschaft, um den Wert anzugeben, der an die ToolTip Eigenschaft eines TreeNode Objekts gebunden werden soll. Diese Bindungsbeziehung wirkt sich auf alle TreeNode Objekte aus, auf die das TreeNodeBinding Objekt angewendet wird. Der QuickInfo-Text wird angezeigt, wenn der Mauszeiger über den Knoten positioniert wird.
Hinweis
Sie können die ToolTip Eigenschaft selektiv außer Kraft setzen, indem Sie die ToolTip Eigenschaft jedes Knotens direkt festlegen.
Anstatt die Eigenschaft zu verwendenToolTip, um denselben ToolTip-Text an jeden Knoten zu binden, können Sie die Eigenschaft eines TreeNode Objekts an ein Feld einer Datenquelle binden, indem Sie die ToolTip ToolTipField 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.