MenuItemBinding.ToolTipField 속성

정의

ToolTip 개체가 적용된 MenuItem 개체의 MenuItemBinding 속성에 바운딩하기 위해 데이터 소스 필드의 이름을 가져오거나 설정합니다.Gets or sets the name of the field from the data source to bind to the ToolTip property of a MenuItem object to which the MenuItemBinding object is applied.

public:
 property System::String ^ ToolTipField { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ToolTipField { get; set; }
member this.ToolTipField : string with get, set
Public Property ToolTipField As String

속성 값

ToolTip이 적용된 MenuItemMenuItemBinding에 바인딩할 필드의 이름입니다.The name of the field to bind to the ToolTip of a MenuItem to which the MenuItemBinding is applied. 기본값은 빈 문자열("")로, 이 속성이 설정되어 있지 않음을 나타냅니다.The default is an empty string (""), which indicates that this property is not set.

특성

예제

다음 코드 예제를 사용 하는 방법에 설명 합니다 ToolTipField 속성에 바인딩할 필드의 이름을 지정 하는 ToolTip 메뉴 항목의 속성입니다.The following code example demonstrates how to use the ToolTipField property to specify the name of the field to bind to the ToolTip property of a menu item. 제대로 작동 하려면이 예제에서는 Menu.xml 라는 파일에 아래 샘플 XML 데이터를 복사 해야 합니다.For this example to work correctly, you must copy the sample XML data below to a file named Menu.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>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <DataBindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            formatstring="({0})" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_self" />
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            formatstring="[{0}]" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            formatstring="<{0}>" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          
        </DataBindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

    </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>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <DataBindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            formatstring="({0})" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_self" />
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            formatstring="[{0}]" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            formatstring="<{0}>" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          
        </DataBindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

    </form>
  </body>
</html>

다음 코드는 이전 예제에 대 한 사이트 맵 데이터 샘플입니다.The following code is sample site map data for the previous example.

<MapHomeNode ImageUrl="~\Images\Home.gif"

Title="Home"

Description="Root Page"

ToolTip="Home Page">

<MapNode ImageUrl="~\Images\Music.gif"

Title="Music"

Description="Music Category"

ToolTip="Music Page">

<MapNode ImageUrl="~\Images\Classical.gif"

Title="Classical"

Description="Classical Section"

ToolTip="Classical Page"/>

<MapNode ImageUrl="~\Images\Rock.gif"

Title="Rock"

Description="Rock Section"

ToolTip="Rock Page"/>

<MapNode ImageUrl="~\Images\Jazz.gif"

Title="Jazz"

Description="Jazz Section"

ToolTip="Jazz Page"/>

</MapNode>

<MapNode ImageUrl="~\Images\Movies.gif"

Title="Movies"

Description="Movies Category"

ToolTip="Movies Page">

<MapNode ImageUrl="~\Images\Action.gif"

Title="Action"

Description="Action Section"

ToolTip="Action Page"/>

<MapNode ImageUrl="~\Images\Drama.gif"

Title="Drama"

Description="Drama Section"

ToolTip="Drama Page"/>

<MapNode ImageUrl="~\Images\Musical.gif"

Title="Musical"

Description="Musical Section"

ToolTip="Musical Page"/>

</MapNode>

</MapHomeNode>

설명

때를 Menu 컨트롤이 데이터 소스에 바인딩된, 사용 하 여를 ToolTipField 속성에 바인딩할 필드의 이름을 지정 하는 ToolTip 의 속성을 MenuItem 개체.When the Menu control is bound to a data source, use the ToolTipField property to specify the name of the field to bind to the ToolTip property of a MenuItem object. 렌더링 될 때를 ToolTip 하려는 각 메뉴 항목의 속성을 MenuItemBinding 개체가 적용 된 필드에서 해당 값을 포함 합니다.When rendered, the ToolTip property of each menu item to which the MenuItemBinding object is applied contains the corresponding value from the field. 지정된 된 텍스트는 메뉴 항목 위로 마우스 포인터를 놓을 때 표시 됩니다.The specified text is displayed when the user positions the mouse pointer over a menu item.

참고

개별 메뉴 항목에 대 한 텍스트를 설정 하 여 재정의할 수 있습니다 해당 ToolTip 속성을 직접.You can override the text for an individual menu item by setting its ToolTip property directly.

바인딩 기준에 설정 하 여 먼저 설정 해야 데이터 원본에 여러 테이블이 나 특성이 있으면, 합니다 Depth 속성을 DataMember 속성 또는 둘 다.If the data source contains multiple tables or attributes, you must first establish the binding criteria by setting the Depth property, the DataMember property, or both.

바인딩할이 속성을 사용 하는 대신 합니다 ToolTip 의 속성을 MenuItem 바인딩할 수 있습니다이 정적 값으로 설정 하 여 필드에 개체를 MenuItemBinding.ToolTip 속성.Instead of using this property to bind the ToolTip property of a MenuItem object to a field, you can also bind it to a static value by setting the MenuItemBinding.ToolTip property. 이는 각 메뉴 항목에 대 한 동일한 도구 설명을 표시할 수 있습니다는 MenuItemBinding 개체 적용 됩니다.This allows you to display the same ToolTip for each menu item to which the MenuItemBinding object is applied.

참고

경우는 ToolTipToolTipField 속성이 모두 설정의 ToolTipField 속성이 우선 합니다.If the ToolTip and ToolTipField properties are both set, the ToolTipField property takes precedence.

적용 대상

추가 정보