Cette documentation est archivée et n’est pas conservée.

HotSpotMode, énumération

Remarque : cette énumération est nouvelle dans le .NET Framework version 2.0.

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

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public enum HotSpotMode
public enum HotSpotMode
public enum HotSpotMode

 Nom de membreDescription
InactiveHotSpot ne possède pas de comportement. 
NavigateHotSpot navigue vers une URL. 
NotSetHotSpot utilise le comportement défini par la propriété HotSpotMode du contrôle ImageMap. Si le contrôle ImageMap ne définit pas le comportement, les objets HotSpot naviguent vers une URL. 
PostBackHotSpot génère une publication sur le serveur. 

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

Si vous spécifiez HotSpotMode.NotSet pour la propriété HotSpot.HotSpotMode d'un objet HotSpot individuel, le HotSpot obtient son comportement de la propriété ImageMap.HotSpotMode contenant le contrôle ImageMap. Dans ce scénario, si la propriété HotSpotMode du contrôle ImageMap a la valeur NotSet ou si aucune valeur n'est spécifiée, la navigation vers une URL est le comportement par défaut.

RemarqueRemarque

Si le comportement d'un contrôle ImageMap n'est pas spécifié en appliquant la propriété ImageMap.HotSpotMode ou la propriété HotSpot.HotSpotMode aux objets HotSpot qu'il contient, le comportement par défaut est HotSpotMode.Navigate. De plus, si les propriétés HotSpot.HotSpotMode appliquées aux objets HotSpot inclus dans un contrôle ImageMap ont la valeur HotSpotMode.NotSet et qu'aucune valeur n'est spécifiée pour la propriété ImageMap.HotSpotMode, le comportement par défaut est HotSpotMode.Navigate.

Si vous spécifiez HotSpotMode.Navigate pour la propriété ImageMap.HotSpotMode ou la propriété HotSpot.HotSpotMode, la page navigue vers une URL lorsque vous cliquez sur HotSpot. Utilisez la propriété Image.NavigateUrl ou la propriété HotSpot.NavigateUrl pour spécifier l'URL à atteindre.

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

Si vous spécifiez HotSpotMode.Inactive pour la propriété HotSpot.HotSpotMode, lorsqu'un clic est effectué sur l'objet HotSpot, cet objet n'a pas de comportement. Vous pouvez utiliser cette valeur pour créer une zone réactive inactive dans une zone réactive active plus grande. Cette option vous permet de créer des zones réactives plus complexes dans un contrôle ImageMap.

Pour créer une zone inactive dans une zone réactive active, vous devez spécifier la zone réactive inactive avant la zone active dans le contrôle ImageMap. Par exemple, le ImageMap suivant définit un cercle actif en spécifiant une zone réactive circulaire inactive dans une zone réactive circulaire active plus 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>
RubriqueEmplacement
Comment : ajouter des contrôles serveur Web ImageMap à une page Web (Visual Studio)Génération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web ImageMap à une page WebGénération d'applications Web ASP.NET dans Visual Studio
Comment : ajouter des contrôles serveur Web ImageMap à une page WebGénération d'applications Web ASP.NET dans Visual Studio

L'exemple de code suivant montre comment utiliser les valeurs d'énumération HotSpotMode pour définir la propriété ImageMap.HotSpotMode. La page contient un contrôle ImageMap qui affiche deux objets RectangleHotSpot. La propriété ImageMap.HotSpotMode a la valeur HotSpotMode.PostBack, ce qui a pour effet de publier la page sur le serveur chaque fois qu'un utilisateur clique sur une zone réactive. La propriété HotSpotMode n'est pas définie pour les objets RectangleHotSpot parce qu'ils obtiennent leur comportement de la propriété ImageMap.HotSpotMode. Pour que cet exemple fonctionne correctement, vous devez fournir votre propre image pour la propriété ImageUrl et mettre à jour le chemin d'accès de l'image de façon à ce que l'application puisse la localiser.

<%@ page language="C#" %>

<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>
<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="Vote 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>

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: