PolygonHotSpot Classe
Definição
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::HotSpotpublic sealed class PolygonHotSpot : System.Web.UI.WebControls.HotSpottype PolygonHotSpot = class
inherit HotSpotPublic NotInheritable Class PolygonHotSpot
Inherits HotSpot- Herança
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) |
