PolygonHotSpot Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Define uma região do ponto de acesso em forma de polígono em um controle ImageMap. Essa 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 a seguir demonstra como criar um ImageMap controle que contém três PolygonHotSpot objetos. Cada PolygonHotSpot objeto representa uma região geográfica no mapa. Quando o usuário clica em um PolygonHotSpot objeto, ele posta de volta no servidor e o tipo e o nome do ponto de acesso são exibidos em um rótulo.

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

Comentários

Essa classe define uma região de ponto de acesso em forma de polígono em um ImageMap controle . O PolygonHotSpot é útil para definir regiões de ponto de acesso irregularmente moldadas em um ImageMap controle. Por exemplo, você 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 como uma cadeia de caracteres que especifica as coordenadas de cada vértice do PolygonHotSpot objeto. Um vértice de polígono é um ponto no qual duas bordas de polígono se encontram.

Quando um PolygonHotSpot objeto é clicado, a página navega até uma URL, gera uma postagem de volta para o servidor ou não faz nada. A HotSpotMode propriedade especifica esse comportamento. Para navegar até uma URL, defina a HotSpotMode propriedade como HotSpotMode.Navigatee use a NavigateUrl propriedade para especificar a URL para a qual navegar. Para postar de volta no servidor, defina a HotSpotMode propriedade HotSpotMode.PostBackcomo e use a PostBackValue propriedade para especificar um nome para o PolygonHotSpot objeto. Esse nome será passado nos dados do ImageMapEventArgs evento quando o PolygonHotSpot for clicado. Se você quiser que o PolygonHotSpot objeto não tenha nenhum comportamento, defina a HotSpotMode propriedade como HotSpotMode.Inactive.

Construtores

PolygonHotSpot()

Inicializa uma nova instância da classe PolygonHotSpot.

Propriedades

AccessKey	Obtém ou define a chave de acesso que permite navegar rapidamente para a região HotSpot. (Herdado de HotSpot)
AlternateText	Obtém ou define o texto alternativo a ser exibido para um objeto HotSpot em um controle ImageMap quando a imagem não está disponível ou é renderizada para um navegador que não dá suporte a imagens. (Herdado de HotSpot)
Coordinates	Uma cadeia de coordenadas que representa os vértices de um objeto PolygonHotSpot.
HotSpotMode	Obtém ou define o comportamento de um objeto HotSpot em um controle ImageMap quando se clica em HotSpot. (Herdado de HotSpot)
IsTrackingViewState	Obtém um valor que indica se o objeto HotSpot está controlando suas alterações de estado de exibição. (Herdado de HotSpot)
MarkupName	Quando substituído em uma classe derivada, obtém a representação de cadeia de caracteres para a forma do objeto HotSpot. (Herdado de HotSpot)
NavigateUrl	Obtém ou define a URL para navegar quando um objeto HotSpot é clicado. (Herdado de HotSpot)
PostBackValue	Obtém ou define o nome do objeto HotSpot a passar nos dados do evento quando o HotSpot é clicado. (Herdado de HotSpot)
TabIndex	Obtém ou define o índice de tabulação da região HotSpot. (Herdado de HotSpot)
Target	Obtém ou define a janela ou o quadro de destino no qual exibir o conteúdo da página da Web vinculada a quando um objeto HotSpot que navega para uma URL é clicado. (Herdado de HotSpot)
ViewState	Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um objeto HotSpot em várias solicitações da mesma página. (Herdado de HotSpot)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetCoordinates()	Retorna uma cadeia de caracteres que representa as coordenadas dos vértices de um objeto PolygonHotSpot.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadViewState(Object)	Restaura o estado de exibição salvo anteriormente do objeto HotSpot para o objeto. (Herdado de HotSpot)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
SaveViewState()	Salva as alterações ao estado de exibição do objeto HotSpot desde a hora em que a página foi postada de volta no servidor. (Herdado de HotSpot)
ToString()	Retorna a representação String desta instância de um objeto HotSpot. (Herdado de HotSpot)
TrackViewState()	Faz com que o objeto HotSpot controle alterações a seu estado de exibição para que eles possam ser armazenadas no objeto StateBag do objeto. Esse objeto é acessível por meio da propriedade ViewState. (Herdado de HotSpot)

Implantações explícitas de interface

IStateManager.IsTrackingViewState	Obtém um valor que indica se o objeto HotSpot está controlando suas alterações de estado de exibição. (Herdado de HotSpot)
IStateManager.LoadViewState(Object)	Restaura o estado de exibição salvo anteriormente do objeto HotSpot para o objeto. (Herdado de HotSpot)
IStateManager.SaveViewState()	Salva as alterações ao estado de exibição do objeto HotSpot desde a última vez em que a página foi postada de volta no servidor. (Herdado de HotSpot)
IStateManager.TrackViewState()	Instrui a região HotSpot a rastrear alterações para seu estado de exibição. (Herdado de HotSpot)

Aplica-se a

Compartilhar via