PolygonHotSpot Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Define uma região de ponto quente em forma de polígono num ImageMap controlo. Esta classe não pode ser herdada.

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

Herança: Object

HotSpot
PolygonHotSpot

Exemplos

O exemplo de código seguinte demonstra como criar um ImageMap controlo que contenha três PolygonHotSpot objetos. Cada PolygonHotSpot objeto representa uma região geográfica no mapa. Quando o utilizador clica num PolygonHotSpot objeto, este é publicado de volta no servidor e o tipo e nome do hotspot são exibidos numa 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>

Observações

Esta classe define uma região de ponto quente em forma de polígono num ImageMap controlo. O PolygonHotSpot é útil para definir regiões de pontos quentes com formas irregulares num ImageMap controlo. Por exemplo, pode usá-lo para definir regiões individuais dentro de um mapa geográfico.

Para definir a região de um PolygonHotSpot, defina a Coordinates propriedade para uma cadeia que especifica as coordenadas de cada vértice do PolygonHotSpot objeto. Um vértice de polígono é um ponto onde duas arestas de polígono se encontram.

Quando um PolygonHotSpot objeto é clicado, a página navega até uma URL, gera uma publicação de volta ao servidor ou não faz nada. A HotSpotMode propriedade especifica este comportamento. Para navegar até uma URL, defina a HotSpotMode propriedade para HotSpotMode.Navigate, e use a NavigateUrl propriedade para especificar a URL para onde navegar. Para publicar de volta ao servidor, defina a HotSpotMode propriedade para HotSpotMode.PostBack, e use a PostBackValue propriedade para especificar um nome para o PolygonHotSpot objeto. Este nome será passado nos ImageMapEventArgs dados do evento quando é clicado PolygonHotSpot . Se quiser que o PolygonHotSpot objeto não tenha comportamento, defina a HotSpotMode propriedade para HotSpotMode.Inactive.

Construtores

Name	Description
PolygonHotSpot()	Inicializa uma nova instância da PolygonHotSpot classe.

Propriedades

Name	Description
AccessKey	Obtém ou define a chave de acesso que permite navegar rapidamente para a HotSpot região. (Herdado de HotSpot)
AlternateText	Obtém ou define o texto alternativo para mostrar para um HotSpot objeto num ImageMap controlo quando a imagem não está disponível ou é renderizado num navegador que não suporta imagens. (Herdado de HotSpot)
Coordinates	Uma cadeia de coordenadas que representa os vértices de um PolygonHotSpot objeto.
HotSpotMode	Obtém ou define o comportamento de um HotSpot objeto num ImageMap controlo quando o HotSpot é clicado. (Herdado de HotSpot)
IsTrackingViewState	Obtém um valor que indica se o HotSpot objeto está a acompanhar as suas alterações de estado de visualização. (Herdado de HotSpot)
MarkupName	Quando sobrescrito numa classe derivada, obtém-se a representação da cadeia para a HotSpot forma do objeto. (Herdado de HotSpot)
NavigateUrl	Obtém ou define a URL para navegar quando um HotSpot objeto é clicado. (Herdado de HotSpot)
PostBackValue	Recebe ou define o nome do HotSpot objeto a passar nos dados do evento quando é clicado HotSpot . (Herdado de HotSpot)
TabIndex	Obtém ou define o índice tab da HotSpot região. (Herdado de HotSpot)
Target	Obtém ou define a janela ou frame-alvo onde mostrar o conteúdo da página Web ligado quando um HotSpot objeto que navega até uma URL é clicado. (Herdado de HotSpot)
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um HotSpot objeto através de múltiplos pedidos para a mesma página. (Herdado de HotSpot)

Métodos

Name	Description
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetCoordinates()	Devolve uma cadeia que representa as coordenadas dos vértices de um PolygonHotSpot objeto.
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadViewState(Object)	Restaura o HotSpot estado de visualização previamente guardado do objeto para o objeto. (Herdado de HotSpot)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
SaveViewState()	Guarda as alterações ao estado de HotSpot visualização do objeto desde o momento em que a página foi publicada de volta no servidor. (Herdado de HotSpot)
ToString()	Devolve a String representação desta instância de um HotSpot objeto. (Herdado de HotSpot)
TrackViewState()	Faz com que o HotSpot objeto acompanhe alterações ao seu estado de visualização para que possam ser armazenadas no objeto do StateBag objeto. Este objeto é acessível através da ViewState propriedade. (Herdado de HotSpot)

Implementações de Interface Explícita

Name	Description
IStateManager.IsTrackingViewState	Obtém um valor que indica se o HotSpot objeto está a acompanhar as suas alterações de estado de visualização. (Herdado de HotSpot)
IStateManager.LoadViewState(Object)	Restaura o HotSpot estado de visualização previamente guardado do objeto para o objeto. (Herdado de HotSpot)
IStateManager.SaveViewState()	Guarda as alterações ao estado de HotSpot visualização do objeto desde a última vez que a página foi publicada de volta no servidor. (Herdado de HotSpot)
IStateManager.TrackViewState()	Instrui a HotSpot região a acompanhar as alterações no estado de visualização. (Herdado de HotSpot)

Aplica-se a

Ver também

Comentários

Esta página foi útil?