Exporter (0) Imprimer
Développer tout
Développer Réduire
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source

HotSpotMode, énumération

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

Nom de membreDescription
NotSet HotSpot 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.
Navigate HotSpot navigue vers une URL.
PostBack HotSpot génère une publication sur le serveur.
Inactive HotSpot ne possède pas de comportement.

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

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 à l'image de façon à ce 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>


.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

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

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft