TreeNodeBinding.ToolTipField プロパティ

.NET Framework クラス ライブラリ リファレンス

TreeNodeBinding.ToolTipField プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

データ ソースからフィールドの名前を取得または設定し、TreeNodeBinding オブジェクトが適用される TreeNode オブジェクトの ToolTip プロパティにバインドします。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property ToolTipField As
 String

Visual Basic (使用法)

Dim instance As TreeNodeBinding
Dim value As String

value = instance.ToolTipField

instance.ToolTipField = value

C#

public string ToolTipField { get;
 set; }

C++

public:
property String^ ToolTipField {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_ToolTipField ()

/** @property */
public void set_ToolTipField (String value)

JScript

public function get ToolTipField
 () : String

public function set ToolTipField
 (value : String)

プロパティ値
TreeNodeBinding オブジェクトが適用される TreeNode オブジェクトの ToolTip プロパティにバインドするフィールドの名前。既定値は空の文字列 ("") です。ToolTipField プロパティが設定されていないことを示します。

解説

TreeView コントロールをデータ ソースにバインドする場合、TreeNode オブジェクトの ToolTip プロパティにバインドするフィールド名は、ToolTipField プロパティで指定します。このバインディングの関係は、TreeNodeBinding オブジェクトが適用されるすべての TreeNode オブジェクトに影響します。ツールヒントのテキストは、マウス ポインタをノードの上に置くと表示されます。

メモ
ToolTipField プロパティは、各ノードの ToolTip プロパティを直接設定することにより、選択的にオーバーライドできます。

ToolTipField プロパティを使用して TreeNode オブジェクトの ToolTip プロパティをフィールドにバインドする代わりに、ToolTip プロパティを設定して、ToolTip プロパティを固定値に設定できます。

メモ
データ ソースに複数のフィールドが含まれている場合は、最初に、Depth プロパティと DataMember プロパティのいずれか、または両方を設定して適切なフィールドにバインドする必要があります。

このプロパティの値はビューステートに格納されます。

使用例

このセクションには、2 つのコード例が含まれています。ToolTipField プロパティを使用して、TreeNodeBinding オブジェクトが適用される TreeNode オブジェクトの ToolTip プロパティに対して、XML 要素のどの属性をバインドするかを指定する方法を最初のコード例に示します。最初のコード例に対応したサンプル XML データを 2 番目のコード例に示します。

ToolTipField プロパティを使用して、TreeNodeBinding オブジェクトが適用される TreeNode オブジェクトの ToolTip プロパティに対して、XML 要素のどの属性をバインドするかを指定する方法を次の例に示します。この例を正常に動作させるには、このコード例の後に示すサンプル XML データを、Booklist.xml という名前のファイルにコピーする必要があります。

Visual Basic

<%@ Page Language="VB" %>

<html>
  <body>
    <form runat="server">
    
      <h3>TreeViewBinding Example</h3>
    
      <!-- Set the TextField, ImageUrlField, NavigateUrlField,
 -->
      <!-- ValueField, and ToolTipField 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" 
            TextField="Text" 
            ImageUrlField="Image"
            ImageToolTipField="ImageToolTip" 
            NavigateUrlField="Nav" 
            ValueField="Value" 
            ToolTipField="Tip"/>
          <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>

C#

<%@ Page Language="C#" %>

<html>
  <body>
    <form runat="server">
    
      <h3>TreeViewBinding Example</h3>
    
      <!-- Set the TextField, ImageUrlField, NavigateUrlField, -->
      <!-- ValueField, and ToolTipField 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" 
            TextField="Text" 
            ImageUrlField="Image"
            ImageToolTipField="ImageToolTip" 
            NavigateUrlField="Nav" 
            ValueField="Value" 
            ToolTipField="Tip"/>
          <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>

前のコード例に対応したサンプル XML データを次のコード例に示します。

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TreeNodeBinding クラス
TreeNodeBinding メンバ
System.Web.UI.WebControls 名前空間
TreeView
TreeNode クラス
DataBindings
TreeNodeBinding.DataMember プロパティ
TreeNodeBinding.Depth プロパティ
TreeNode.ImageUrl プロパティ
TreeNodeBinding.ImageUrl プロパティ
TreeNodeBinding.ImageUrlField プロパティ
TreeNodeBinding.ImageToolTip プロパティ
TreeNodeBinding.ImageToolTipField プロパティ
TreeNode.NavigateUrl プロパティ
TreeNodeBinding.NavigateUrl プロパティ
TreeNodeBinding.NavigateUrlField プロパティ
TreeNode.Text プロパティ
TreeNodeBinding.Text プロパティ
TreeNodeBinding.TextField プロパティ
TreeNode.ToolTip プロパティ
TreeNodeBinding.ToolTip プロパティ
TreeNode.Value プロパティ
TreeNodeBinding.Value
ValueField