Partilhar via


RectangleHotSpot Classe

Definição

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::HotSpot
public sealed class RectangleHotSpot : System.Web.UI.WebControls.HotSpot
type RectangleHotSpot = class
    inherit HotSpot
Public NotInheritable Class RectangleHotSpot
Inherits HotSpot
Herança
RectangleHotSpot

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)

Aplica-se a

Confira também