Compartir vía


PolygonHotSpot Clase

Definición

Define una región de zona activa de forma poligonal en un control ImageMap. Esta clase no puede heredarse.

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
Herencia
PolygonHotSpot

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un ImageMap control que contiene tres PolygonHotSpot objetos. Cada PolygonHotSpot objeto representa una región geográfica en el mapa. Cuando el usuario hace clic en un PolygonHotSpot objeto, se devuelve al servidor y el tipo y el nombre de la zona activa se muestran en una etiqueta.

<%@ 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>

Comentarios

Esta clase define una región de zona activa en forma de polígono en un ImageMap control . PolygonHotSpot es útil para definir regiones de zonas activas con forma irregular en un ImageMap control . Por ejemplo, puede usarlo para definir regiones individuales dentro de un mapa geográfico.

Para definir la región de un PolygonHotSpot, establezca la Coordinates propiedad en una cadena que especifique las coordenadas de cada vértice del PolygonHotSpot objeto. Un vértice de polígono es un punto en el que se encuentran dos bordes de polígono.

Cuando se hace clic en un PolygonHotSpot objeto, la página navega a una dirección URL, genera una publicación de vuelta al servidor o no hace nada. La HotSpotMode propiedad especifica este comportamiento. Para navegar a una dirección URL, establezca la HotSpotMode propiedad HotSpotMode.Navigateen y use la NavigateUrl propiedad para especificar la dirección URL a la que navegar. Para volver a publicar en el servidor, establezca la HotSpotMode propiedad HotSpotMode.PostBacken y use la PostBackValue propiedad para especificar un nombre para el PolygonHotSpot objeto . Este nombre se pasará en los datos del ImageMapEventArgs evento cuando PolygonHotSpot se haga clic en . Si desea que el PolygonHotSpot objeto no tenga ningún comportamiento, establezca la HotSpotMode propiedad HotSpotMode.Inactiveen .

Constructores

PolygonHotSpot()

Inicializa una nueva instancia de la clase PolygonHotSpot.

Propiedades

AccessKey

Obtiene o establece la tecla de acceso que permite navegar rápidamente a la región HotSpot.

(Heredado de HotSpot)
AlternateText

Obtiene o establece el texto alternativo para mostrar en un objeto HotSpot de un control ImageMap cuando la imagen no está disponible o se representa en un explorador que no admite imágenes.

(Heredado de HotSpot)
Coordinates

Cadena de coordenadas que representa los vértices de un objeto PolygonHotSpot.

HotSpotMode

Especifica o establece el comportamiento de un objeto HotSpot en un control ImageMap cuando se hace clic en HotSpot.

(Heredado de HotSpot)
IsTrackingViewState

Obtiene un valor que indica si el objeto HotSpot realiza el seguimiento de los cambios de su estado de vista.

(Heredado de HotSpot)
MarkupName

Cuando se reemplaza en una clase derivada, obtiene la representación de cadena para la forma del objeto HotSpot.

(Heredado de HotSpot)
NavigateUrl

Obtiene o establece la dirección URL de destino cuando se hace clic en un objeto HotSpot.

(Heredado de HotSpot)
PostBackValue

Obtiene o establece el nombre del objeto HotSpot que se pasará en los datos de evento cuando se haga clic en HotSpot.

(Heredado de HotSpot)
TabIndex

Obtiene o establece el índice de tabulación de la región HotSpot.

(Heredado de HotSpot)
Target

Obtiene o establece la ventana o el marco de destino donde debe mostrarse el contenido de la página Web a la que se vincula al hacer clic en un objeto HotSpot que navegue a una dirección URL.

(Heredado de HotSpot)
ViewState

Obtiene un diccionario con información de estado que permite guardar y restaurar el estado de vista de un objeto HotSpot en las distintas solicitudes de la misma página.

(Heredado de HotSpot)

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetCoordinates()

Devuelve una cadena que representa las coordenadas de los vértices de un objeto PolygonHotSpot.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
LoadViewState(Object)

Restaura el estado de vista previamente guardado del objeto HotSpot al objeto.

(Heredado de HotSpot)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
SaveViewState()

Guarda los cambios realizados en el estado de la vista del objeto HotSpot desde el momento en que se devolvió la página al servidor.

(Heredado de HotSpot)
ToString()

Devuelve la representación String de esta instancia de un objeto HotSpot.

(Heredado de HotSpot)
TrackViewState()

Hace que el objeto HotSpot efectúe el seguimiento de los cambios de su estado de vista a fin de que se puedan almacenar en su objeto StateBag. Este objeto es accesible a través de la propiedad ViewState.

(Heredado de HotSpot)

Implementaciones de interfaz explícitas

IStateManager.IsTrackingViewState

Obtiene un valor que indica si el objeto HotSpot realiza el seguimiento de los cambios de su estado de vista.

(Heredado de HotSpot)
IStateManager.LoadViewState(Object)

Restaura el estado de vista previamente guardado del objeto HotSpot al objeto.

(Heredado de HotSpot)
IStateManager.SaveViewState()

Guarda los cambios realizados en el estado de la vista del objeto HotSpot desde la última vez que se devolvió la página al servidor.

(Heredado de HotSpot)
IStateManager.TrackViewState()

Indica a la región HotSpot que efectúe el seguimiento de los cambios de su estado de vista.

(Heredado de HotSpot)

Se aplica a

Consulte también