TreeNodeBinding.ImageToolTip Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia tekst etykietki narzędzia dla obrazu wyświetlanego obok węzła, do którego TreeNodeBinding jest stosowany obiekt.
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 StringWartość właściwości
Tekst etykietki narzędzia dla obrazu wyświetlanego obok węzła, do którego TreeNodeBinding zastosowano obiekt. Wartość domyślna to pusty ciąg (""), który wskazuje, że właściwość P:System.Web.UI.WebControls.TreeNodeBinding.ImageToolTip nie jest ustawiona.
Przykłady
Ten rozdział zawiera dwa przykłady kodu. W pierwszym przykładzie kodu pokazano, jak za pomocą ImageToolTip właściwości określić tekst etykietki narzędzia dla obrazu wyświetlanego obok węzła, do którego TreeNodeBinding zastosowano obiekt. Drugi przykład kodu zawiera przykładowe dane XML dla pierwszego przykładu kodu.
W poniższym przykładzie pokazano, jak za pomocą ImageToolTip właściwości określić tekst etykietki narzędzia dla obrazu wyświetlanego obok węzła, do którego TreeNodeBinding zastosowano obiekt. Aby ten przykład działał poprawnie, należy skopiować przykładowe dane XML podane po tym przykładzie kodu do pliku o nazwie 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>
Poniższy przykład kodu zawiera przykładowe dane XML dla poprzedniego przykładu kodu.
<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>
Uwagi
Gdy kontrolka TreeView jest powiązana ze źródłem danych, użyj ImageToolTip właściwości , aby określić wartość, która ma być powiązana ImageToolTip z właściwością TreeNode obiektu. Określony tekst zawiera informacje o urządzeniach z technologią asystywną z opisem obrazu, który może służyć do zwiększenia dostępności kontroli.
Ta relacja powiązania ma wpływ na wszystkie TreeNode obiekty, do których TreeNodeBinding jest stosowany obiekt. Gdy obraz jest wyświetlany obok węzła, tekst Etykietka narzędzia jest wyświetlany, gdy wskaźnik myszy jest umieszczony na obrazie.
Uwaga
Właściwość można selektywnie zastąpić ImageToolTip , ustawiając ImageToolTip właściwość każdego węzła bezpośrednio.
Zamiast używać ImageToolTip właściwości do powiązania tego samego tekstu etykietki narzędzia z każdym obrazem węzła, można powiązać ImageToolTip właściwość TreeNode obiektu z polem źródła danych, ustawiając ImageToolTipField właściwość .
Wartość tej właściwości jest przechowywana w stanie widoku.
Wartość tej właściwości, po ustawieniu, można zapisać automatycznie w pliku zasobów przy użyciu narzędzia projektanta. Aby uzyskać więcej informacji, zobacz LocalizableAttribute temat Globalizacja i Lokalizacja.