PolygonHotSpot Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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: Object

HotSpot
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

PolygonHotSpot Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

Comentarios

Recursos adicionales