HotSpotMode HotSpotMode HotSpotMode HotSpotMode Enum

Definizione

Specifica i comportamenti di un oggetto HotSpot in un controllo ImageMap quando viene fatto clic su HotSpot.Specifies the behaviors of a HotSpot object in an ImageMap control when the HotSpot is clicked.

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

Campi

Inactive Inactive Inactive Inactive 3

L'oggetto HotSpot non ha alcun comportamento.The HotSpot does not have any behavior.

Navigate Navigate Navigate Navigate 1

L'oggetto HotSpot causa lo spostamento su un URL.The HotSpot navigates to a URL.

NotSet NotSet NotSet NotSet 0

L'oggetto HotSpot utilizza il comportamento impostato dalla proprietà ImageMap del controllo HotSpotMode.The HotSpot uses the behavior set by the ImageMap control's HotSpotMode property. Se il controllo ImageMap non definisce il comportamento, l'oggetto HotSpot causerà lo spostamento su un URL.If the ImageMap control does not define the behavior, the HotSpot object navigates to a URL.

PostBack PostBack PostBack PostBack 2

L'oggetto HotSpot genera un postback al server.The HotSpot generates a postback to the server.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato HotSpotMode come utilizzare i valori di ImageMap.HotSpotMode enumerazione per impostare la proprietà.The following code example demonstrates how to use the HotSpotMode enumeration values to set the ImageMap.HotSpotMode property. La pagina contiene un ImageMap controllo che contiene due RectangleHotSpot oggetti.The page contains an ImageMap control that contains two RectangleHotSpot objects. La ImageMap.HotSpotMode proprietà è impostata su HotSpotMode.PostBack, che consente di eseguire il postback della pagina al server ogni volta che un utente fa clic su una delle aree sensibili.The ImageMap.HotSpotMode property is set to HotSpotMode.PostBack, which causes the page to post back to the server each time a user clicks one of the hot spot regions. La HotSpotMode proprietà non è impostata su nessuno RectangleHotSpot degli oggetti perché ImageMap.HotSpotMode ottiene il comportamento dalla proprietà.The HotSpotMode property is not set on either of the RectangleHotSpot objects because they get their behavior from the ImageMap.HotSpotMode property. Per il corretto funzionamento di questo esempio, è necessario fornire un'immagine personalizzata per ImageUrl la proprietà e aggiornare il percorso dell'immagine in modo appropriato affinché possa essere individuato dall'applicazione.For this example to work correctly, you must supply your own image for the ImageUrl property and update the path to the image appropriately so that the application can locate it.

<%@ 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' HotSpotMode enumerazione rappresenta i comportamenti che è possibile applicare a un HotSpot oggetto all'interno di ImageMap un controllo.The HotSpotMode enumeration represents the behaviors that you can apply to a HotSpot object within an ImageMap control. Le ImageMap.HotSpotMode proprietàHotSpot.HotSpotMode e utilizzano questi valori di enumerazione per impostare il comportamento di un HotSpot oggetto quando viene selezionato.The ImageMap.HotSpotMode and the HotSpot.HotSpotMode properties use these enumeration values to set the behavior of a HotSpot object when it is clicked. Se entrambe le proprietà sono impostate, HotSpot.HotSpotMode la proprietà specificata in ogni HotSpot singolo ImageMap.HotSpotMode oggetto ha la precedenza sulla proprietà del controllo.If both properties are set, the HotSpot.HotSpotMode property specified on each individual HotSpot object takes precedence over the ImageMap.HotSpotMode property on the control.

Se si specifica HotSpotMode.NotSet per la HotSpot.HotSpotMode proprietà di HotSpot un singolo HotSpot oggetto, ottiene il comportamento della ImageMap.HotSpotMode proprietà del controllo ImageMap che lo contiene.If you specify HotSpotMode.NotSet for the HotSpot.HotSpotMode property of an individual HotSpot object, the HotSpot gets its behavior from the containing ImageMap control's ImageMap.HotSpotMode property. In questo scenario, se la ImageMap HotSpotMode proprietà del controllo è NotSet o non è specificato alcun valore, il comportamento predefinito consiste nel passare a un URL.In this scenario, if the ImageMap control's HotSpotMode property is either NotSet or no value is specified, the default behavior is to navigate to a URL.

Nota

Se il ImageMap comportamento di un controllo non viene specificato utilizzando la ImageMap.HotSpotMode proprietà o HotSpot.HotSpotMode la proprietà per gli HotSpot oggetti in esso contenuti, per impostazione predefinita il HotSpotMode.Navigatecomportamento è.If an ImageMap control's behavior is not specified using either the ImageMap.HotSpotMode property or the HotSpot.HotSpotMode property on the HotSpot objects it contains, by default the behavior is HotSpotMode.Navigate. HotSpot.HotSpotMode Inoltre, se le proprietà degli HotSpot oggetti contenuti in un ImageMap controllo sono impostate HotSpotMode.NotSet su e non viene specificato alcun valore per la ImageMap.HotSpotMode proprietà, il comportamento predefinito è HotSpotMode.Navigate.In addition, if the HotSpot.HotSpotMode properties on the HotSpot objects that an ImageMap control contains are set to HotSpotMode.NotSet and no value is specified for the ImageMap.HotSpotMode property, the default behavior is HotSpotMode.Navigate.

Se si specifica HotSpotMode.Navigate per la ImageMap.HotSpotMode proprietà o HotSpot.HotSpotMode la proprietà, la HotSpot pagina passa a un URL quando si fa clic su.If you specify HotSpotMode.Navigate for either the ImageMap.HotSpotMode property or the HotSpot.HotSpotMode property, the page navigates to a URL when the HotSpot is clicked. Usare la Image.NavigateUrl HotSpot.NavigateUrl proprietà o per specificare l'URL a cui passare.Use the Image.NavigateUrl or the HotSpot.NavigateUrl property to specify the URL to navigate to.

Se si specifica HotSpotMode.PostBack per la ImageMap.HotSpotMode proprietà o HotSpot.HotSpotMode la proprietà, la pagina HotSpot genera un postback al server quando si fa clic su.If you specify HotSpotMode.PostBack for either the ImageMap.HotSpotMode property or the HotSpot.HotSpotMode property, the page generates a postback to the server when the HotSpot is clicked. Utilizzare la PostBackValue proprietà per specificare un nome per l' HotSpot oggetto.Use the PostBackValue property to specify a name for the HotSpot object. Questo nome verrà passato nei ImageMapEventArgs dati dell'evento quando si verifica l'evento di postback.This name will be passed in the ImageMapEventArgs event data when the postback event occurs. Quando si fa HotSpot clic su un postback, Click viene generato l'evento.When a postback HotSpot is clicked, the Click event is raised. Per controllare a livello di codice le azioni eseguite quando HotSpot si fa clic su un postback, fornire un gestore Click eventi per l'evento.To programmatically control the actions performed when a postback HotSpot is clicked, provide an event handler for the Click event.

Se si specifica HotSpotMode.Inactive per la HotSpot.HotSpotMode proprietà, l' HotSpot oggetto non ha alcun comportamento quando viene selezionato.If you specify HotSpotMode.Inactive for the HotSpot.HotSpotMode property, the HotSpot object does not have any behavior when it is clicked. È possibile usare questo valore per creare un'area sensibile inattiva all'interno di un'area sensibile attiva più grande.You can use this value to create an inactive hot spot within a larger active hot spot. Questa opzione è disponibile per consentire di creare zone sensibili più complesse all'interno di un ImageMap controllo.This option is provided to allow you to create more complex hot spot zones within an ImageMap control.

Per creare un'area inattiva all'interno di un punto di interesse attivo, è necessario specificare l'area sensibile inattiva prima di quella ImageMap attiva nel controllo.To create an inactive area within an active hot spot, you must specify the inactive hot spot before the active one in the ImageMap control. Il codice seguente ImageMap , ad esempio, definisce un anello attivo specificando un'area sensibile circolare inattiva all'interno di un'area sensibile circolare attiva più grande:For example, the following ImageMap defines an active ring by specifying an inactive circular hot spot within a larger active circular hot spot:

<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