Questa documentazione è stata archiviata e non viene gestita.

Enumerazione HotSpotMode

Aggiornamento: novembre 2007

Specifica i comportamenti di un oggetto HotSpot in un controllo ImageMap quando viene fatto clic su HotSpot.

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

public enum HotSpotMode
public enum HotSpotMode
public enum HotSpotMode

Nome membroDescrizione
NotSetL'oggetto HotSpot utilizza il comportamento impostato dalla proprietà HotSpotMode del controllo ImageMap. Se il controllo ImageMap non definisce il comportamento, l'oggetto HotSpot causerà lo spostamento su un URL.
NavigateL'oggetto HotSpot causa lo spostamento su un URL.
PostBackL'oggetto HotSpot genera un postback al server.
InactiveL'oggetto HotSpot non ha alcun comportamento.

L'enumerazione HotSpotMode rappresenta i comportamenti che possono essere applicati a un oggetto HotSpot all'interno di un controllo ImageMap. Le proprietà ImageMap.HotSpotMode e HotSpot.HotSpotMode utilizzano questi valori di enumerazione per impostare il comportamento di un oggetto HotSpot quando viene fatto clic su di esso. Se vengono impostate entrambe le proprietà, la proprietà HotSpot.HotSpotMode specificata per ogni singolo oggetto HotSpot avrà la priorità sulla proprietà ImageMap.HotSpotMode specificata per il controllo.

Se si specifica HotSpotMode.NotSet per la proprietà HotSpot.HotSpotMode di un singolo oggetto HotSpot, il comportamento dell'oggetto HotSpot sarà determinato dalla proprietà ImageMap.HotSpotMode del controllo ImageMap in cui è contenuto l'oggetto. In questo scenario, se per la proprietà HotSpotMode del controllo ImageMap è specificato il valore NotSet oppure non è specificato alcun valore, il comportamento predefinito sarà lo spostamento su un URL.

Nota:

Se il comportamento di un controllo ImageMap non viene specificato utilizzando la proprietà ImageMap.HotSpotMode o HotSpot.HotSpotMode degli oggetti HotSpot contenuti nel controllo, per impostazione predefinita il comportamento sarà HotSpotMode.Navigate. Se inoltre le proprietà HotSpot.HotSpotMode degli oggetti HotSpot contenuti in un controllo ImageMap sono impostate su HotSpotMode.NotSet e non è specificato alcun valore per la proprietà ImageMap.HotSpotMode, il comportamento predefinito sarà HotSpotMode.Navigate.

Se si specifica HotSpotMode.Navigate per la proprietà ImageMap.HotSpotMode o HotSpot.HotSpotMode, la pagina accede a un URL quando viene fatto clic su HotSpot. Utilizzare la proprietà Image.NavigateUrl o HotSpot.NavigateUrl per specificare l'URL di destinazione.

Se si specifica HotSpotMode.PostBack per la proprietà ImageMap.HotSpotMode o HotSpot.HotSpotMode, la pagina genera un postback al server quando viene fatto clic su HotSpot. Utilizzare la proprietà PostBackValue per specificare un nome per l'oggetto HotSpot. Questo nome viene passato nei dati dell'evento ImageMapEventArgs quando si verifica l'evento di postback. Quando viene fatto clic su un oggetto HotSpot di postback, viene generato l'evento Click. Per controllare a livello di codice le azioni eseguite quando viene fatto clic su un oggetto HotSpot di postback, fornire un gestore eventi per l'evento Click.

Se si specifica HotSpotMode.Inactive per la proprietà HotSpot.HotSpotMode, l'oggetto HotSpot non ha alcun comportamento quando viene fatto clic su di esso. È possibile utilizzare questo valore per creare un'area sensibile inattiva all'interno di un'area sensibile attiva più grande. In questo modo si ha la possibilità di creare aree sensibili più complesse in un controllo ImageMap.

Per creare un'area inattiva all'interno di un'area sensibile attiva, è necessario specificare l'area sensibile inattiva prima dell'area sensibile attiva nel controllo ImageMap. Ad esempio, il seguente oggetto ImageMap definisce un anello attivo specificando un'area sensibile circolare inattiva all'interno di un'area sensibile circolare attiva più grande:

    <asp:ImageMap ID="SaturnImage" 
           ImageUrl="~/saturn.PNG" 
           runat="server" OnClick="SaturnImage_Click">
        <asp:CircleHotSpot AlternateText="planet" HotSpotMode=PostBack
              PostBackValue="planet" Radius=40 X=100 Y=100 />

        <asp:CircleHotSpot HotSpotMode=Inactive 
              Radius=60 X=100 Y=100 />
        <asp:CircleHotSpot AlternateText="rings" HotSpotMode=PostBack
              PostBackValue="rings" Radius=80 X=100 Y=100 />
    </asp:ImageMap>
TopicLocation
Procedura: aggiungere controlli server Web ImageMap a una pagina Web (Visual Studio)Generazione di applicazioni Web ASP.NET in Visual Studio
Procedura: aggiungere controlli server Web ImageMap a una pagina WebCompilazione di applicazioni Web ASP.NET in Visual Studio
Procedura: aggiungere controlli server Web ImageMap a una pagina WebCompilazione di applicazioni Web ASP.NET in Visual Studio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare i valori dell'enumerazione HotSpotMode per impostare la proprietà ImageMap.HotSpotMode. Nella pagina è incluso un controllo ImageMap contenente due oggetti RectangleHotSpot. Poiché la proprietà ImageMap.HotSpotMode è impostata su HotSpotMode.PostBack, la pagina verrà restituita al server (postback) ogni volta che un utente farà clic su una delle aree sensibili. La proprietà HotSpotMode non è impostata per uno degli oggetti RectangleHotSpot in quanto il loro comportamento è definito dalla proprietà ImageMap.HotSpotMode. Perché questo esempio funzioni correttamente, è necessario fornire una propria immagine per la proprietà ImageUrl e aggiornare il percorso dell'immagine in modo che possa essere individuata dall'applicazione.

<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void VoteMap_Clicked(object sender, ImageMapEventArgs e)
  {       
    // When a user clicks the "Yes" hot spot,
    // display the hot spot's value.
    if (e.PostBackValue == "Yes")
      Message1.Text = "You selected " + e.PostBackValue + ".";

    else if (e.PostBackValue == "No") 
      // When a user clicks the "No" hot spot,
      // display the hot spot's value.       
      Message1.Text = "You selected " + e.PostBackValue + ".";

    else
      Message1.Text = "You did not click a valid hot spot region.";             
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap.HotSpotMode Example</title>
</head>
  <body>
    <form id="form1" runat="server">

      <h3>ImageMap.HotSpotMode Example</h3>

      <!--The RectangleHotSpot objects have the post back
        behavior specified by the HotSpotMode 
        property on the ImageMap control.-->
      <asp:imagemap id="Vote"           
        imageurl="Images/VoteImage.jpg"
        alternatetext="Voting choices" 
        hotspotmode="PostBack"
        onclick="VoteMap_Clicked"   
        runat="Server">   

        <asp:RectangleHotSpot          
          top="0"
          left="0"
          bottom="354"
          right="250"
          postbackvalue="Yes"
          alternatetext="Vote yes">
        </asp:RectangleHotSpot>

        <asp:RectangleHotSpot 
          top="0"
          left="251"
          bottom="354"
          right="500"
          postbackvalue="No"
          alternatetext="Vote no">
        </asp:RectangleHotSpot>

      </asp:imagemap>

      <br />

      <asp:label id="Message1"
        runat="Server">
      </asp:label>

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


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

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0, 2.0
Mostra: