HotSpotMode Enumerazione

Definizione

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

public enum class HotSpotMode
public enum HotSpotMode
type HotSpotMode = 
Public Enum HotSpotMode
Ereditarietà
HotSpotMode

Campi

Inactive 3

L'oggetto HotSpot non ha alcun comportamento.

Navigate 1

L'oggetto HotSpot causa lo spostamento su un URL.

NotSet 0

L'oggetto HotSpot utilizza il comportamento impostato dalla proprietà ImageMap del controllo HotSpotMode. Se il controllo ImageMap non definisce il comportamento, l'oggetto HotSpot causerà lo spostamento su un URL.

PostBack 2

L'oggetto HotSpot genera un postback al server.

Esempio

Nell'esempio di codice seguente viene illustrato come usare i valori di HotSpotMode enumerazione per impostare la ImageMap.HotSpotMode proprietà. La pagina contiene un ImageMap controllo contenente due RectangleHotSpot oggetti. La ImageMap.HotSpotMode proprietà è impostata su HotSpotMode.PostBack, che causa il postback della pagina al server ogni volta che un utente fa clic su una delle aree di accesso frequente. La HotSpotMode proprietà non è impostata su uno degli RectangleHotSpot oggetti perché ottiene il ImageMap.HotSpotMode comportamento dalla proprietà. Per il corretto funzionamento di questo esempio, è necessario specificare la propria immagine per la ImageUrl proprietà e aggiornare il percorso dell'immagine in modo appropriato in modo che l'applicazione possa individuarla.

<%@ 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>
<%@ page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    
  Sub VoteMap_Clicked(ByVal sender As Object, ByVal e As ImageMapEventArgs)
            
    ' When a user clicks the "Yes" hot spot,
    ' display the hot spot's value.
    If (e.PostBackValue = "Yes") Then
      Message1.Text = "You selected " & e.PostBackValue & "."
       
      ' When a user clicks the "No" hot spot,
      ' display the hot spot's value.
    ElseIf (e.PostBackValue = "No") Then
      Message1.Text = "You selected " & e.PostBackValue & "."
      
    Else
      Message1.Text = "You did not click a valid hot spot region."
                
    End If
  End Sub
  
</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>

Commenti

L'enumerazione HotSpotMode rappresenta i comportamenti che è possibile applicare a un oggetto all'interno di un HotSpotImageMap controllo. Le ImageMap.HotSpotMode proprietà e HotSpot.HotSpotMode usano questi valori di enumerazione per impostare il comportamento di un HotSpot oggetto quando viene fatto clic. Se entrambe le proprietà vengono impostate, la proprietà specificata in ogni singolo HotSpot oggetto ha la HotSpot.HotSpotMode precedenza sulla proprietà sul ImageMap.HotSpotMode controllo.

Se si specifica HotSpotMode.NotSet per la HotSpot.HotSpotMode proprietà di un singolo HotSpot oggetto, il HotSpot comportamento viene ottenuto dalla proprietà del ImageMap.HotSpotMode controllo contenenteImageMap. In questo scenario, se la proprietà del HotSpotMode controllo è NotSet o non viene specificato alcun valore, il comportamento predefinito consiste nel ImageMap passare a un URL.

Nota

Se il comportamento di un ImageMap controllo non viene specificato usando la proprietà o la HotSpot.HotSpotModeImageMap.HotSpotMode proprietà sugli HotSpot oggetti che contiene, per impostazione predefinita il comportamento è HotSpotMode.Navigate. Inoltre, se le HotSpot.HotSpotMode proprietà degli HotSpot oggetti che un ImageMap controllo contiene sono impostate su HotSpotMode.NotSet e non viene specificato alcun valore per la ImageMap.HotSpotMode proprietà, il comportamento predefinito è HotSpotMode.Navigate.

Se si specifica HotSpotMode.Navigate per la proprietà o la ImageMap.HotSpotModeHotSpot.HotSpotMode proprietà, la pagina passa a un URL quando viene HotSpot fatto clic su . Utilizzare o la Image.NavigateUrlHotSpot.NavigateUrl proprietà per specificare l'URL da passare.

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

Se si specifica HotSpotMode.Inactive per la proprietà, l'oggetto HotSpot.HotSpotModeHotSpot non ha alcun comportamento quando viene fatto clic. È possibile usare questo valore per creare un punto caldo inattivo all'interno di un punto caldo attivo più grande. Questa opzione viene fornita per consentire di creare zone di spot più complesse all'interno di un ImageMap controllo.

Per creare un'area inattiva all'interno di un punto di accesso frequente attivo, è necessario specificare il punto di accesso inattivo prima di quello attivo nel ImageMap controllo. Ad esempio, il seguente ImageMap definisce un anello attivo specificando un punto caldo circolare inattivo all'interno di un punto caldo circolare 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>  

Si applica a

Vedi anche