RectangleHotSpot 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 retangular do ponto de acesso em um controle ImageMap. Essa classe não pode ser herdada.
public ref class RectangleHotSpot sealed : System::Web::UI::WebControls::HotSpotpublic sealed class RectangleHotSpot : System.Web.UI.WebControls.HotSpottype RectangleHotSpot = class
inherit HotSpotPublic NotInheritable Class RectangleHotSpot
Inherits HotSpot- Herança
Exemplos
O exemplo de código a seguir demonstra como criar declarativamente um ImageMap controle que contém dois RectangleHotSpot objetos . A ImageMap.HotSpotMode propriedade é definida HotSpotMode.PostBackcomo , o que faz com que a página seja postada novamente no servidor sempre que um usuário clica em uma das regiões de ponto de acesso. Sempre que o usuário clica em um dos RectangleHotSpot objetos, o GetCoordinates método é chamado e as coordenadas do ponto de acesso selecionado são exibidas para o usuário. Para que este exemplo funcione corretamente, você deve fornecer sua própria imagem para a ImageUrl propriedade e atualizar o caminho para a imagem adequadamente para que o aplicativo possa localizá-la.
<%@ 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 VoteMap_Clicked (Object sender, ImageMapEventArgs e)
{
string coordinates;
string hotSpotType;
int yescount = ((ViewState["yescount"] != null)? (int)ViewState["yescount"] : 0);
int nocount = ((ViewState["nocount"] != null)? (int)ViewState["nocount"] : 0);
// When a user clicks the "Yes" hot spot,
// display the hot spot's name and coordinates.
if (e.PostBackValue.Contains("Yes"))
{
yescount += 1;
coordinates = Vote.HotSpots[0].GetCoordinates();
hotSpotType = Vote.HotSpots[0].ToString ();
Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue + ".<br />" +
"The coordinates are " + coordinates + ".<br />" +
"The current vote count is " + yescount.ToString() +
" yes votes and " + nocount.ToString() + " no votes.";
}
// When a user clicks the "No" hot spot,
// display the hot spot's name and coordinates.
else if (e.PostBackValue.Contains("No"))
{
nocount += 1;
coordinates = Vote.HotSpots[1].GetCoordinates();
hotSpotType = Vote.HotSpots[1].ToString ();
Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue + ".<br />" +
"The coordinates are " + coordinates + ".<br />" +
"The current vote count is " + yescount.ToString() +
" yes votes and " + nocount.ToString() + " no votes.";
}
else
{
Message1.Text = "You did not click a valid hot spot region.";
}
ViewState["yescount"] = yescount;
ViewState["nocount"] = nocount;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>ImageMap Class Post Back Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageMap Class Post Back Example</h3>
<asp:imagemap id="Vote"
imageurl="Images/VoteImage.jpg"
width="400"
height="200"
alternatetext="Vote Yes or No"
hotspotmode="PostBack"
onclick="VoteMap_Clicked"
runat="Server">
<asp:RectangleHotSpot
top="0"
left="0"
bottom="200"
right="200"
postbackvalue="Yes"
alternatetext="Vote yes">
</asp:RectangleHotSpot>
<asp:RectangleHotSpot
top="0"
left="201"
bottom="200"
right="400"
postbackvalue="No"
alternatetext="Vote no">
</asp:RectangleHotSpot>
</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 VoteMap_Clicked(ByVal sender As Object, ByVal e As ImageMapEventArgs)
Dim coordinates As String
Dim hotSpotType As String
Dim yescount As Integer
Dim nocount As Integer
If (ViewState("yescount") IsNot Nothing) Then
yescount = Convert.ToInt32(ViewState("yescount"))
Else
yescount = 0
End If
If (ViewState("nocount") IsNot Nothing) Then
nocount = Convert.ToInt32(ViewState("nocount"))
Else
nocount = 0
End If
' When a user clicks the "Yes" hot spot,
' display the hot spot's name and coordinates.
If (e.PostBackValue.Contains("Yes")) Then
yescount += 1
coordinates = Vote.HotSpots(0).GetCoordinates()
hotSpotType = Vote.HotSpots(0).ToString()
Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue & ".<br />" & _
"The coordinates are " & coordinates & ".<br />" & _
"The current vote count is " & yescount.ToString() & _
" yes votes and " & nocount.ToString() & " no votes."
' When a user clicks the "No" hot spot,
' display the hot spot's name and coordinates.
ElseIf (e.PostBackValue.Contains("No")) Then
nocount += 1
coordinates = Vote.HotSpots.Item(1).GetCoordinates()
hotSpotType = Vote.HotSpots.Item(1).ToString()
Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue & ".<br />" & _
"The coordinates are " & coordinates & ".<br />" & _
"The current vote count is " & yescount.ToString() & _
" yes votes and " & nocount.ToString() & " no votes."
Else
Message1.Text = "You did not click a valid hot spot region."
End If
ViewState("yescount") = yescount
ViewState("nocount") = nocount
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>ImageMap Class Post Back Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageMap Class Post Back Example</h3>
<asp:imagemap id="Vote"
imageurl="Images/VoteImage.jpg"
width="400"
height="200"
alternatetext="Vote Yes or No"
hotspotmode="PostBack"
onclick="VoteMap_Clicked"
runat="Server">
<asp:RectangleHotSpot
top="0"
left="0"
bottom="200"
right="200"
postbackvalue="Yes"
alternatetext="Vote yes">
</asp:RectangleHotSpot>
<asp:RectangleHotSpot
top="0"
left="201"
bottom="200"
right="400"
postbackvalue="No"
alternatetext="Vote no">
</asp:RectangleHotSpot>
</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 retangular em um ImageMap controle . Para definir a região do objeto, defina RectangleHotSpot a Left propriedade como o valor que representa a coordenada x do canto superior esquerdo da região retangular. Defina a Top propriedade como o valor que representa a coordenada y do canto superior esquerdo da região retangular. Defina a Right propriedade como o valor que representa a coordenada x do canto inferior direito da região retangular. Defina a Bottom propriedade como o valor que representa a coordenada y do canto inferior direito da região retangular.
Quando um RectangleHotSpot controle é 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.Navigate e use a NavigateUrl propriedade para especificar a URL para a qual navegar. Para postar de volta no servidor, defina a HotSpotMode propriedade HotSpotMode.PostBack como e use a PostBackValue propriedade para especificar um nome para o RectangleHotSpot objeto. Esse nome será passado nos dados do ImageMapEventArgs evento quando o RectangleHotSpot for clicado. . Se você quiser que o HotSpot objeto não tenha nenhum comportamento, defina a HotSpotMode propriedade como HotSpotMode.Inactive.
Construtores
| RectangleHotSpot() |
Inicializa uma nova instância da classe RectangleHotSpot. |
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) |
| Bottom |
Obtém ou define a coordenada y do lado inferior da região retangular definida por este objeto RectangleHotSpot. |
| 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) |
| Left |
Obtém ou define a coordenada x do lado esquerdo da região retangular definida por este objeto RectangleHotSpot. |
| 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) |
| Right |
Obtém ou define a coordenada x do lado direito da região retangular definida por este objeto RectangleHotSpot. |
| 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) |
| Top |
Obtém ou define a coordenada y do lado superior da região retangular definida por este objeto RectangleHotSpot. |
| 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 x e y do canto superior esquerdo de um objeto RectangleHotSpot e as coordenadas x e y de seu canto inferior direito. |
| 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) |
