PolygonHotSpot Classe

  • Référence

Définition

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

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
Object
HotSpot
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. Il PolygonHotSpot est utile de définir des régions de points chauds en forme irrégulière dans un ImageMap contrôle. Par exemple, vous pouvez l’utiliser pour définir des régions individuelles au sein d’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 vertex de l’objet PolygonHotSpot . Un sommet de polygone est un point auquel se rencontrent deux arêtes de polygones.

Lorsqu’un PolygonHotSpot objet est cliqué, la page accède à une URL, génère un billet sur le serveur ou ne fait rien. La HotSpotMode propriété spécifie ce comportement. Pour accéder à une URL, définissez la HotSpotMode propriété sur et utilisez la NavigateUrl propriété HotSpotMode.Navigatepour spécifier l’URL à accéder. Pour revenir au serveur, définissez la propriété sur , puis utilisez la HotSpotMode PostBackValue propriété pour spécifier un nom pour l’objetPolygonHotSpot.HotSpotMode.PostBack Ce nom est transmis dans les ImageMapEventArgs données d’événement lorsque le PolygonHotSpot clic est fait. Si vous souhaitez que l’objet PolygonHotSpot n’ait aucun comportement, définissez la HotSpotMode propriété sur HotSpotMode.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