MenuItemBinding.ToolTip Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Hämtar eller anger knappbeskrivningstexten för ett menyalternativ som MenuItemBinding objektet tillämpas på.

public:
 property System::String ^ ToolTip { System::String ^ get(); void set(System::String ^ value); };
public string ToolTip { get; set; }
member this.ToolTip : string with get, set
Public Property ToolTip As String

Egenskapsvärde

String

Knappbeskrivningstexten för ett menyalternativ som MenuItemBinding används. Standardvärdet är en tom sträng (") som anger att den här egenskapen inte har angetts.

Exempel

Följande kodexempel visar hur du använder ToolTip egenskapen för att ange knappbeskrivning som ska visas när användaren placerar muspekaren över ett menyalternativ. Den här knappbeskrivningen visas för varje menyalternativ som MenuItemBinding objektet tillämpas på. För att det här exemplet ska fungera korrekt måste du kopiera XML-exempeldata nedan till en fil med namnet 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"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            text="Static Title"
            value="Static Description"
            imageurl="~\Images\StaticImage.jpg"
            tooltip="Static ToolTip"/>
          
        </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"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            text="Static Title"
            value="Static Description"
            imageurl="~\Images\StaticImage.jpg"
            tooltip="Static ToolTip"/>
          
        </databindings>
        
      </asp:menu>

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

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

Följande kod är exempel på webbplatsöversiktsdata för föregående exempel.

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

Kommentarer

När kontrollen Menu är bunden till en datakälla använder du ToolTip egenskapen för att ange texten som ska bindas till MenuItem.ToolTip egenskapen för ett MenuItem objekt. Den här knappbeskrivningen delas med alla menyalternativ som MenuItemBinding objektet tillämpas på. När användaren placerar muspekaren över ett menyalternativ visas den angivna texten.

Note

Du kan åsidosätta knappbeskrivningen för ett enskilt menyalternativ genom att ange dess ToolTip egenskap direkt.

I stället för att använda den här egenskapen för att ange samma knappbeskrivning för varje menyalternativ kan du också binda ToolTip egenskapen för ett MenuItem objekt till ett fält i en datakälla genom att ange ToolTipField egenskapen. När det ToolTip återges innehåller egenskapen för varje menyobjekt som MenuItemBinding objektet tillämpas på motsvarande värde från fältet.

Note

ToolTip Om båda egenskaperna och ToolTipField anges har egenskapen ToolTipField företräde.

Värdet för den här egenskapen kan när den anges sparas automatiskt i en resursfil med hjälp av ett designerverktyg. Mer information finns i LocalizableAttributeglobalisering och lokalisering.

Gäller för

Se även