Partager via


PolygonHotSpot Classe

Définition

Définit une zone réactive en forme de polygone dans un contrôle ImageMap. Cette classe ne peut pas être héritée.

public ref class PolygonHotSpot sealed : System::Web::UI::WebControls::HotSpot
public sealed class PolygonHotSpot : System.Web.UI.WebControls.HotSpot
type PolygonHotSpot = class
    inherit HotSpot
Public NotInheritable Class PolygonHotSpot
Inherits HotSpot
Héritage
PolygonHotSpot

Exemples

L’exemple de code suivant montre comment créer un ImageMap contrôle qui contient trois PolygonHotSpot objets. Chaque PolygonHotSpot objet représente une région géographique sur la carte. Lorsque l’utilisateur clique sur un PolygonHotSpot objet, il publie sur le serveur et le type et le nom du point chaud sont affichés dans une étiquette.

<%@ 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 RegionMap_Clicked (object sender, ImageMapEventArgs e)
  {
    string hotSpotType;

    // When a user clicks a hot spot, display
    // the hot spot's type and name.
    switch (e.PostBackValue)
    {
      case "Western":
        hotSpotType = Regions.HotSpots[0].ToString();
        Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue;
        break;
        
      case "Northern":
        hotSpotType = Regions.HotSpots[1].ToString();
        Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue;
        break;

      case "Southern":
        hotSpotType = Regions.HotSpots[2].ToString();
        Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue;
        break;

      default:
        Message1.Text = "You did not click a valid hot spot region.";
        break;
    }
  }  
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>PolygonHotSpot Class Example</title>
</head>
  <body>
    <form id="Form1" runat="server">
    
      <h3>PolygonHotSpot Example</h3>
      
      <!-- Change or remove the width and height attributes as
           appropriate for your image. -->
      <asp:imagemap id="Regions"           
        imageurl="Images/RegionMap.jpg"
        alternatetext="Sales regions" 
        hotspotmode="PostBack"
        width="400"
        height="400"
        onclick="RegionMap_Clicked"   
        runat="Server">            
          
        <asp:PolygonHotSpot 
          coordinates="0,0,176,0,125,182,227,400,0,400"         
          postbackvalue="Western"
          alternatetext="Western Region">
        </asp:PolygonHotSpot>
          
        <asp:PolygonHotSpot 
          coordinates="177,0,400,0,400,223,335,154,127,180"         
          postbackvalue="Northern"
          alternatetext="Northern Region">
        </asp:PolygonHotSpot>
        
        <asp:PolygonHotSpot 
          coordinates="128,185,335,157,400,224,400,400,228,400"         
          postbackvalue="Southern"
          alternatetext="Southern Region">
        </asp:PolygonHotSpot>
      
      </asp:imagemap>
            
      <br /><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 RegionMap_Clicked(ByVal sender As Object, ByVal e As ImageMapEventArgs)
    Dim hotSpotType As String
        
    ' When a user clicks a hot spot, display
    ' the hot spot's type and name.
    Select Case (e.PostBackValue)
      
      Case ("Western")
        hotSpotType = Regions.HotSpots(0).ToString()
        Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue
      
      Case ("Northern")
        hotSpotType = Regions.HotSpots(1).ToString()
        Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue
      
      Case ("Southern")
        hotSpotType = Regions.HotSpots(2).ToString()
        Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue
      
      Case Else
        Message1.Text = "You did not click a valid hot spot region."
    
    End Select

  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>PolygonHotSpot Class Example</title>
</head>
  <body>
    <form id="Form1" runat="server">
    
      <h3>PolygonHotSpot Example</h3>
      
      <!-- Change or remove the width and height attributes as
           appropriate for your image. -->
      <asp:imagemap id="Regions"           
        imageurl="Images/RegionMap.jpg"
        alternatetext="Sales regions" 
        hotspotmode="PostBack"
        width="400"
        height="400"
        onclick="RegionMap_Clicked"   
        runat="Server">            
          
        <asp:PolygonHotSpot 
          coordinates="0,0,176,0,125,182,227,400,0,400"         
          postbackvalue="Western"
          alternatetext="Western Region">
        </asp:PolygonHotSpot>
          
        <asp:PolygonHotSpot 
          coordinates="177,0,400,0,400,223,335,154,127,180"         
          postbackvalue="Northern"
          alternatetext="Northern Region">
        </asp:PolygonHotSpot>
        
        <asp:PolygonHotSpot 
          coordinates="128,185,335,157,400,224,400,400,228,400"         
          postbackvalue="Southern"
          alternatetext="Southern Region">
        </asp:PolygonHotSpot>
      
      </asp:imagemap>
            
      <br /><br />
          
      <asp:label id="Message1"
        runat="Server">
      </asp:label>                 
                 
    </form>      
  </body>
</html>

Remarques

Cette classe définit une région de point chaud en forme de polygone dans un ImageMap contrôle. Le PolygonHotSpot est utile pour définir des régions de point chaud de forme irrégulière dans un ImageMap contrôle. Par exemple, vous pouvez l’utiliser pour définir des régions individuelles dans une carte géographique.

Pour définir la région d’un PolygonHotSpot, définissez la Coordinates propriété sur une chaîne qui spécifie les coordonnées de chaque sommet de l’objet PolygonHotSpot . Un sommet de polygone est un point auquel deux bords de polygones se rencontrent.

Lorsque l’utilisateur clique sur un PolygonHotSpot objet, la page accède à une URL, génère une publication sur le serveur ou ne fait rien. La HotSpotMode propriété spécifie ce comportement. Pour accéder à une URL, définissez la propriété HotSpotMode.Navigatesur HotSpotMode et utilisez la NavigateUrl propriété pour spécifier l’URL à laquelle accéder. Pour effectuer une publication sur le serveur, affectez à HotSpotMode.PostBackla propriété la HotSpotMode valeur , puis utilisez la PostBackValue propriété pour spécifier un nom pour l’objet PolygonHotSpot . Ce nom est passé dans les données d’événement ImageMapEventArgs lorsque l’utilisateur PolygonHotSpot clique sur . Si vous souhaitez que l’objet PolygonHotSpot n’ait aucun comportement, définissez la propriété sur HotSpotModeHotSpotMode.Inactive.

Constructeurs

PolygonHotSpot()

Initialise une nouvelle instance de la classe PolygonHotSpot.

Propriétés

AccessKey

Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers la région HotSpot.

(Hérité de HotSpot)
AlternateText

Obtient ou définit le texte de remplacement à afficher pour un objet HotSpot d'un contrôle ImageMap lorsque l'image n'est pas disponible ou s'affiche sur un navigateur qui ne prend pas en charge les images.

(Hérité de HotSpot)
Coordinates

Chaîne des coordonnées qui représente les sommets d'un objet PolygonHotSpot.

HotSpotMode

Obtient ou définit le comportement d'un objet HotSpot d'un contrôle ImageMap suite à un clic sur HotSpot.

(Hérité de HotSpot)
IsTrackingViewState

Obtient une valeur indiquant si l'objet HotSpot effectue le suivi des modifications de son état d'affichage.

(Hérité de HotSpot)
MarkupName

En cas de substitution dans une classe dérivée, obtient la représentation sous forme de chaîne de la forme de l'objet HotSpot.

(Hérité de HotSpot)
NavigateUrl

Obtient ou définit l'URL à laquelle accéder lors d'un clic sur un objet HotSpot.

(Hérité de HotSpot)
PostBackValue

Obtient ou définit le nom de l'objet HotSpot à passer dans les données d'événement lors d'un clic sur HotSpot.

(Hérité de HotSpot)
TabIndex

Obtient ou définit l'index de tabulation de la région HotSpot.

(Hérité de HotSpot)
Target

Obtient ou définit la fenêtre ou le frame cible sur lequel afficher le contenu de la page Web vers laquelle un lien est établi lorsqu'un clic est effectué sur un objet HotSpot qui navigue vers une URL.

(Hérité de HotSpot)
ViewState

Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un objet HotSpot entre plusieurs demandes de la même page.

(Hérité de HotSpot)

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetCoordinates()

Retourne une chaîne qui représente les coordonnées des sommets d'un objet PolygonHotSpot.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
LoadViewState(Object)

Restaure sur l'objet l'état d'affichage précédemment enregistré de l'objet HotSpot.

(Hérité de HotSpot)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
SaveViewState()

Enregistre les modifications apportées à l'état d'affichage de l'objet HotSpot depuis la publication de la page sur le serveur.

(Hérité de HotSpot)
ToString()

Retourne la représentation String de cette instance d'un objet HotSpot.

(Hérité de HotSpot)
TrackViewState()

Amène l'objet HotSpot à suivre les modifications de son état d'affichage afin qu'elles puissent être stockées dans l'objet StateBag de l'objet. Cet objet est accessible via la propriété ViewState.

(Hérité de HotSpot)

Implémentations d’interfaces explicites

IStateManager.IsTrackingViewState

Obtient une valeur indiquant si l'objet HotSpot effectue le suivi des modifications de son état d'affichage.

(Hérité de HotSpot)
IStateManager.LoadViewState(Object)

Restaure sur l'objet l'état d'affichage précédemment enregistré de l'objet HotSpot.

(Hérité de HotSpot)
IStateManager.SaveViewState()

Enregistre les modifications apportées à l'état d'affichage de l'objet HotSpot depuis la dernière publication de la page sur le serveur.

(Hérité de HotSpot)
IStateManager.TrackViewState()

Indique à la région HotSpot de suivre les modifications apportées à son état d'affichage.

(Hérité de HotSpot)

S’applique à

Voir aussi