ImageMap.HotSpotMode Proprietà

Definizione

Ottiene o imposta il comportamento predefinito degli oggetti HotSpot di un controllo ImageMap quando viene fatto clic sugli oggetti HotSpot.Gets or sets the default behavior for the HotSpot objects of an ImageMap control when the HotSpot objects are clicked.

public:
 virtual property System::Web::UI::WebControls::HotSpotMode HotSpotMode { System::Web::UI::WebControls::HotSpotMode get(); void set(System::Web::UI::WebControls::HotSpotMode value); };
public virtual System.Web.UI.WebControls.HotSpotMode HotSpotMode { get; set; }
member this.HotSpotMode : System.Web.UI.WebControls.HotSpotMode with get, set
Public Overridable Property HotSpotMode As HotSpotMode

Valore della proprietà

Uno dei valori dell'enumerazione HotSpotMode.One of the HotSpotMode enumeration values. Il valore predefinito è NotSet.The default is NotSet.

Eccezioni

Il tipo specificato non è uno dei valori dell'enumerazione HotSpotMode.The specified type is not one of the HotSpotMode enumeration values.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come creare in modo dichiarativo un controllo ImageMap contenente due oggetti RectangleHotSpot.The following code example demonstrates how to declaratively create an ImageMap control that contains two RectangleHotSpot objects. La proprietà ImageMap.HotSpotMode è 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 proprietà HotSpotMode non è impostata su ognuno degli oggetti RectangleHotSpot perché ottiene il proprio comportamento dalla proprietà ImageMap.HotSpotMode.The HotSpotMode property is not set on each 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 la proprietà ImageUrl 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

Utilizzare la proprietà HotSpotMode per specificare il comportamento di clic predefinito degli oggetti HotSpot all'interno di un controllo ImageMap.Use the HotSpotMode property to specify the default click behavior of the HotSpot objects within an ImageMap control. Questa proprietà viene impostata utilizzando uno dei valori di enumerazione HotSpotMode.This property is set using one of the HotSpotMode enumeration values. Nella tabella seguente sono elencati i valori possibili.The following table lists the possible values.

ElementoItem DescrizioneDescription
Inactive Il HotSpot oggetto non ha alcun comportamento.The HotSpot object does not have any behavior.
NotSet L'oggetto HotSpot usa il comportamento impostato dalla proprietà HotSpotMode del controllo ImageMap.The HotSpot object uses the behavior set by the ImageMap control's HotSpotMode property. Se il controllo ImageMap non definisce il comportamento, tutti gli oggetti HotSpot passano a un URL.If the ImageMap control does not define the behavior, the HotSpot objects all navigate to a URL.
Navigate Gli oggetti HotSpot passano a un URL.The HotSpot objects navigate to a URL.
PostBack Gli oggetti HotSpot generano un postback al server.The HotSpot objects generate a postback to the server.

È possibile specificare il comportamento di un oggetto HotSpot usando la proprietà ImageMap.HotSpotMode del controllo ImageMap o la proprietà HotSpot.HotSpotMode di ogni singolo oggetto HotSpot.You can specify a HotSpot object's behavior using either the ImageMap.HotSpotMode property of the ImageMap control or the HotSpot.HotSpotMode property of each individual HotSpot object. Se entrambe le proprietà sono impostate, la proprietà HotSpot.HotSpotMode specificata in ogni singolo HotSpot oggetto ha la precedenza sulla proprietà ImageMap.HotSpotMode nel controllo ImageMap.If both properties are set, the HotSpot.HotSpotMode property specified on each individual HotSpot object takes precedence over the ImageMap.HotSpotMode property on the ImageMap control.

Quando si imposta la proprietà HotSpotMode del controllo ImageMap, si noti che i valori di HotSpotMode.NotSet e HotSpotMode.Navigate hanno lo stesso comportamento: entrambi passano a un URL.When you set the HotSpotMode property of the ImageMap control, note that the HotSpotMode.NotSet and HotSpotMode.Navigate values have the same behavior: both navigate to a URL. Quando si specifica HotSpotMode.NotSet per la proprietà HotSpot.HotSpotMode di un singolo oggetto HotSpot, tale HotSpot ne determina il comportamento dal valore della proprietà HotSpotMode del controllo ImageMap.When you specify HotSpotMode.NotSet for the HotSpot.HotSpotMode property of an individual HotSpot object, that HotSpot determines its behavior from the value of the HotSpotMode property of the ImageMap control.

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

Se si specifica HotSpotMode.PostBack per la proprietà ImageMap.HotSpotMode, la pagina genera un postback al server quando si fa clic sul HotSpot.If you specify HotSpotMode.PostBack for the ImageMap.HotSpotMode property, the page generates a postback to the server when the HotSpot is clicked. Usare la proprietà PostBackValue per specificare il nome dell'area sensibile.Use the PostBackValue property to specify the name of the hot spot region. Questo nome verrà passato nei dati dell'evento ImageMapEventArgs quando si verifica un evento di postback.This name will be passed in the ImageMapEventArgs event data when a postback event occurs. Quando si fa clic su un HotSpot di postback, viene generato l'evento Click.When a postback HotSpot is clicked, the Click event is raised. Per controllare a livello di codice le azioni eseguite quando si fa clic su un HotSpot di postback, fornire un gestore eventi per l'evento Click.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 proprietà HotSpot.HotSpotMode, l'oggetto HotSpot non avrà 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 controllo ImageMap.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 dell'area sensibile attiva nel controllo ImageMap.To create an inactive area within an active hot spot, you must specify the inactive hot spot before the active hot spot in the ImageMap control. Il ImageMap seguente, 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>  

Per fare in modo che tutti gli oggetti HotSpot in un controllo ImageMap abbiano lo stesso comportamento, utilizzare la proprietà HotSpotMode sul controllo ImageMap per specificare il comportamento.To cause all HotSpot objects in an ImageMap control to have the same behavior, use the HotSpotMode property on the ImageMap control to specify the behavior. Impostare quindi la proprietà HotSpotMode per ogni singolo oggetto HotSpot su HotSpotMode.NotSet o non specificare un valore per la proprietà HotSpot.HotSpotMode.Then, either set the HotSpotMode property on each individual HotSpot object to HotSpotMode.NotSet or do not specify a value for the HotSpot.HotSpotMode property.

Per specificare comportamenti diversi per HotSpot oggetti in un controllo ImageMap, impostare la proprietà HotSpot.HotSpotMode per ogni singolo oggetto HotSpot su HotSpotMode.Navigate, HotSpotMode.PostBacko HotSpotMode.Inactive.To specify different behaviors for HotSpot objects in an ImageMap control, set the HotSpot.HotSpotMode property on each individual HotSpot object to either HotSpotMode.Navigate, HotSpotMode.PostBack, or HotSpotMode.Inactive.

Nota

Se la proprietà ImageMap.HotSpotMode di un controllo ImageMap o la proprietà HotSpot.HotSpotMode in uno qualsiasi degli oggetti HotSpot in esso contenuti è impostata su HotSpotMode.NotSet o non è impostata su un valore, per impostazione predefinita il comportamento è HotSpotMode.Navigate.If an ImageMap control's ImageMap.HotSpotMode property or the HotSpot.HotSpotMode property on any of the HotSpot objects it contains is either set to HotSpotMode.NotSet or not set to a value, by default the behavior is HotSpotMode.Navigate.

Si applica a

Vedi anche