HotSpotMode Énumération

Définition

Spécifie les comportements d'un objet HotSpot dans un contrôle ImageMap suite à un clic sur HotSpot.

public enum class HotSpotMode
public enum HotSpotMode
type HotSpotMode = 
Public Enum HotSpotMode
Héritage
HotSpotMode

Champs

Inactive 3

HotSpot ne possède pas de comportement.

Navigate 1

HotSpot navigue vers une URL.

NotSet 0

HotSpot utilise le comportement défini par la propriété ImageMap du contrôle HotSpotMode. Si le contrôle ImageMap ne définit pas le comportement, les objets HotSpot naviguent vers une URL.

PostBack 2

HotSpot génère une publication sur le serveur.

Exemples

L’exemple de code suivant montre comment utiliser les valeurs d’énumération HotSpotMode pour définir la ImageMap.HotSpotMode propriété . La page contient un ImageMap contrôle qui contient deux RectangleHotSpot objets. La ImageMap.HotSpotMode propriété est définie sur HotSpotMode.PostBack, ce qui entraîne la publication de la page sur le serveur chaque fois qu’un utilisateur clique sur l’une des régions de point chaud. La HotSpotMode propriété n’est définie sur aucun des RectangleHotSpot objets, car ils obtiennent leur comportement à partir de la ImageMap.HotSpotMode propriété . Pour que cet exemple fonctionne correctement, vous devez fournir votre propre image pour la ImageUrl propriété et mettre à jour le chemin d’accès à l’image de manière appropriée afin que l’application puisse la localiser.

<%@ 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>

Remarques

L’énumération HotSpotMode représente les comportements que vous pouvez appliquer à un HotSpot objet dans un ImageMap contrôle . Les ImageMap.HotSpotMode propriétés et HotSpot.HotSpotMode utilisent ces valeurs d’énumération pour définir le comportement d’un HotSpot objet lorsque l’utilisateur clique dessus. Si les deux propriétés sont définies, la HotSpot.HotSpotMode propriété spécifiée sur chaque objet individuel HotSpot est prioritaire sur la ImageMap.HotSpotMode propriété du contrôle.

Si vous spécifiez HotSpotMode.NotSet pour la HotSpot.HotSpotMode propriété d’un objet individuelHotSpot, le HotSpot obtient son comportement à partir de la propriété du ImageMap.HotSpotMode contrôle contenantImageMap. Dans ce scénario, si la ImageMap propriété du HotSpotMode contrôle est NotSet ou si aucune valeur n’est spécifiée, le comportement par défaut consiste à accéder à une URL.

Notes

Si le comportement d’un ImageMap contrôle n’est pas spécifié à l’aide de la ImageMap.HotSpotMode propriété ou de la HotSpot.HotSpotMode propriété sur les HotSpot objets qu’il contient, par défaut, le comportement est HotSpotMode.Navigate. En outre, si les propriétés sur les HotSpotHotSpot.HotSpotMode objets qu’un ImageMap contrôle contient sont définies sur HotSpotMode.NotSet et qu’aucune valeur n’est spécifiée pour la ImageMap.HotSpotMode propriété, le comportement par défaut est HotSpotMode.Navigate.

Si vous spécifiez HotSpotMode.Navigate pour la ImageMap.HotSpotMode propriété ou la HotSpot.HotSpotMode propriété, la page accède à une URL lorsque l’utilisateur HotSpot clique sur . Utilisez la Image.NavigateUrlHotSpot.NavigateUrl propriété ou pour spécifier l’URL à laquelle accéder.

Si vous spécifiez HotSpotMode.PostBack pour la ImageMap.HotSpotMode propriété ou la HotSpot.HotSpotMode propriété, la page génère une publication sur le serveur lorsque HotSpot l’utilisateur clique sur . Utilisez la PostBackValue propriété pour spécifier un nom pour l’objet HotSpot . Ce nom est transmis dans les données d’événement ImageMapEventArgs lorsque l’événement de publication se produit. Lorsque vous cliquez sur une publication HotSpot , l’événement Click est déclenché. Pour contrôler par programmation les actions effectuées lorsque l’utilisateur clique sur une publication HotSpot , fournissez un gestionnaire d’événements pour l’événement Click .

Si vous spécifiez HotSpotMode.Inactive pour la HotSpot.HotSpotMode propriété, l’objet HotSpot n’a aucun comportement lorsque l’utilisateur clique dessus. Vous pouvez utiliser cette valeur pour créer un point chaud inactif au sein d’un point chaud actif plus grand. Cette option est fournie pour vous permettre de créer des zones de point chaud plus complexes au sein d’un ImageMap contrôle.

Pour créer une zone inactive dans un point d’accès actif, vous devez spécifier le point chaud inactif avant celui actif dans le ImageMap contrôle. Par exemple, les éléments suivants ImageMap définissent un anneau actif en spécifiant un point chaud circulaire inactif au sein d’un point chaud circulaire actif plus grand :

<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>  

S’applique à

Voir aussi