HotSpotMode Enumerazione

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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à
Object
ValueType
Enum
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 utilizzare i HotSpotMode valori di enumerazione per impostare la ImageMap.HotSpotMode proprietà . La pagina contiene un ImageMap controllo che contiene due RectangleHotSpot oggetti. La ImageMap.HotSpotMode proprietà è impostata su HotSpotMode.PostBack, che determina la postback della pagina al server ogni volta che un utente fa clic su una delle aree ad accesso frequente. La HotSpotMode proprietà non è impostata su uno degli RectangleHotSpot oggetti perché ottengono il comportamento dalla ImageMap.HotSpotMode 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 utilizzano questi valori di enumerazione per impostare il comportamento di un HotSpot oggetto quando viene fatto clic. Se vengono impostate entrambe le proprietà, la HotSpot.HotSpotMode proprietà specificata in ogni singolo HotSpot oggetto ha la ImageMap.HotSpotMode precedenza sulla proprietà nel controllo .

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

Nota

Se il comportamento di un ImageMap controllo non viene specificato utilizzando la ImageMap.HotSpotMode proprietà o la HotSpot.HotSpotMode proprietà negli HotSpot oggetti in esso contenuti, per impostazione predefinita il comportamento è HotSpotMode.Navigate. Inoltre, se le HotSpot.HotSpotMode proprietà degli HotSpot oggetti contenuti da un ImageMap controllo 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 ImageMap.HotSpotMode proprietà o la HotSpot.HotSpotMode proprietà , la pagina passa a un URL quando HotSpot si fa clic su . Usare o la Image.NavigateUrlHotSpot.NavigateUrl proprietà per specificare l'URL a cui passare.

Se si specifica HotSpotMode.PostBack per la ImageMap.HotSpotMode proprietà o la HotSpot.HotSpotMode proprietà , la pagina genera un postback al server quando HotSpot si fa clic su . 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 di postback. Quando si fa clic su un postback HotSpot , viene generato l'evento Click . Per controllare a livello di codice le azioni eseguite quando si fa clic su un postback HotSpot , specificare un gestore eventi per l'evento Click .

Se si specifica HotSpotMode.Inactive per la HotSpot.HotSpotMode proprietà , l'oggetto HotSpot non ha alcun comportamento quando viene fatto clic su di esso. È possibile usare questo valore per creare un'area ad accesso frequente inattiva all'interno di un'area ad accesso frequente più grande. Questa opzione è disponibile per consentire di creare zone di accesso frequente più complesse all'interno di un ImageMap controllo.

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