ImageMap.HotSpotMode Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit le comportement par défaut pour les objets HotSpot d'un contrôle ImageMap lorsqu'un clic est effectué sur les objets HotSpot.

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

Valeur de propriété

HotSpotMode

Une des valeurs d'énumération HotSpotMode. La valeur par défaut est NotSet.

Exceptions

ArgumentOutOfRangeException

Le type spécifié ne fait pas partie des valeurs d'énumération HotSpotMode.

Exemples

L’exemple de code suivant montre comment créer de manière déclarative 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 pas définie sur chacun 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

Utilisez la HotSpotMode propriété pour spécifier le comportement de clic par défaut des HotSpot objets au sein d’un ImageMap contrôle. Cette propriété est définie à l’aide de l’une des valeurs d’énumération HotSpotMode . Le tableau suivant répertorie les valeurs possibles.

Élément	Description
`Inactive`	L’objet HotSpot n’a aucun comportement.
`NotSet`	L’objet HotSpot utilise le comportement défini par la ImageMap propriété du HotSpotMode contrôle. Si le ImageMap contrôle ne définit pas le comportement, les HotSpot objets accèdent tous à une URL.
`Navigate`	Les HotSpot objets accèdent à une URL.
`PostBack`	Les HotSpot objets génèrent une publication sur le serveur.

Vous pouvez spécifier le comportement d’un HotSpot objet à l’aide de la ImageMap.HotSpotMode propriété du ImageMap contrôle ou de la HotSpot.HotSpotMode propriété de chaque objet individuel HotSpot . 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 ImageMap contrôle.

Lorsque vous définissez la HotSpotMode propriété du ImageMap contrôle, notez que les HotSpotMode.NotSet valeurs et HotSpotMode.Navigate ont le même comportement : les deux accèdent à une URL. Lorsque vous spécifiez HotSpotMode.NotSet pour la HotSpot.HotSpotMode propriété d’un objet individuel HotSpot , cela HotSpot détermine son comportement à partir de la valeur de la HotSpotMode propriété du ImageMap contrôle.

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

Si vous spécifiez HotSpotMode.PostBack pour la ImageMap.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 le nom de la région de point chaud. Ce nom est transmis dans les données d’événement ImageMapEventArgs lorsqu’un é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 chaud actif, vous devez spécifier le point chaud inactif avant le point d’accès 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>

Pour que tous les HotSpot objets d’un ImageMap contrôle aient le même comportement, utilisez la HotSpotMode propriété sur le ImageMap contrôle pour spécifier le comportement. Ensuite, définissez la HotSpotMode propriété sur chaque objet HotSpotMode.NotSet individuel HotSpot sur ou ne spécifiez pas de valeur pour la HotSpot.HotSpotMode propriété.

Pour spécifier différents comportements pour HotSpot les objets d’un ImageMap contrôle, définissez la HotSpot.HotSpotMode propriété sur chaque objet individuel HotSpot sur HotSpotMode.Navigate, HotSpotMode.PostBackou HotSpotMode.Inactive.

Notes

Si la propriété d’un contrôle ou la HotSpot.HotSpotMode propriété sur l’un HotSpot des objets qu’il contient est définie sur ou n’est pas définie HotSpotMode.NotSet sur une valeur, par défaut, le comportement est HotSpotMode.Navigate.ImageMap ImageMap.HotSpotMode

S’applique à