Esporta (0) Stampa
Espandi tutto

Proprietà MenuItemBinding.ToolTipField

Ottiene o imposta il nome del campo dall'origine dati per l'associazione alla proprietà ToolTip di un oggetto MenuItem a cui è applicato l'oggetto MenuItemBinding.

Spazio dei nomi: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

[TypeConverterAttribute("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")] 
public string ToolTipField { get; set; }
/** @property */
public String get_ToolTipField ()

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

public function get ToolTipField () : String

public function set ToolTipField (value : String)

Non applicabile.

Valore proprietà

Nome del campo da associare alla proprietà ToolTip di un oggetto MenuItem a cui è applicato l'oggetto MenuItemBinding. Il valore predefinito è una stringa vuota (""), a indicare che questa proprietà non è impostata.

Quando il controllo Menu è associato a un'origine dati, utilizzare la proprietà ToolTipField per specificare il nome del campo da associare alla proprietà ToolTip di un oggetto MenuItem. Quando si esegue il rendering, la proprietà ToolTip di ciascuna voce di menu a cui è applicato l'oggetto MenuItemBinding contiene il valore corrispondente dal campo. Il testo specificato viene visualizzato quando l'utente posiziona il puntatore del mouse su una voce di menu.

NotaNota:

È possibile eseguire l'override di una singola voce di menu impostandone direttamente la proprietà ToolTip.

Se l'origine dati contiene più tabelle o attributi, è necessario innanzitutto stabilire i criteri di associazione impostando la proprietà Depth, la proprietà DataMember o entrambe.

Anziché utilizzare questa proprietà per associare la proprietà ToolTip di un oggetto MenuItem a un campo, è anche possibile associarla a un valore statico tramite l'impostazione della proprietà MenuItemBinding.ToolTip. In questo modo è possibile visualizzare la stessa descrizione comandi per ciascuna voce di menu a cui è applicato l'oggetto MenuItemBinding.

NotaNota:

Se le proprietà ToolTip e ToolTipField sono entrambe impostate, la proprietà ToolTipField ha la precedenza.

Nell'esempio riportato di seguito viene illustrato come utilizzare la proprietà ToolTipField per specificare il nome del campo da associare alla proprietà ToolTip di una voce di menu. Perché questo esempio funzioni correttamente, è necessario copiare i dati XML di esempio che seguono in un file denominato 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>


Nel codice riportato di seguito sono riportati i dati della mappa del sito di esempio per l'esempio precedente.

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

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 è supportato in Windows Vista, Microsoft Windows XP SP2 e Windows Server 2003 SP1.

.NET Framework

Supportato in:

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft