RectangleHotSpot Classe

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 de ponto de acesso retangular em um ImageMap controle. 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: Object

HotSpot
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 como HotSpotMode.PostBack, o que faz com que a página poste de volta 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 RectangleHotSpot objeto, defina 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 para 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 HotSpotMode.Navigate e use a NavigateUrl propriedade para especificar a URL para a qual navegar. Para postar novamente no servidor, defina a HotSpotMode propriedade HotSpotMode.PostBack 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 clique for clicado. . Se você quiser que o HotSpot objeto não tenha nenhum comportamento, defina a HotSpotMode propriedade como HotSpotMode.Inactive.

Construtores

Nome	Description
RectangleHotSpot()	Inicializa uma nova instância da classe RectangleHotSpot.

Propriedades

Nome	Description
AccessKey	Obtém ou define a chave de acesso que permite navegar rapidamente até a HotSpot região. (Herdado de HotSpot)
AlternateText	Obtém ou define o texto alternativo a ser exibido para um objeto em um HotSpot ImageMap controle quando a imagem não está disponível ou é renderizada em 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 RectangleHotSpot objeto.
HotSpotMode	Obtém ou define o comportamento de um HotSpot objeto em um ImageMap controle quando ele HotSpot é clicado. (Herdado de HotSpot)
IsTrackingViewState	Obtém um valor que indica se o HotSpot objeto está acompanhando 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 esse RectangleHotSpot objeto.
MarkupName	Quando substituído em uma classe derivada, obtém a representação de cadeia de caracteres para a HotSpot forma do objeto. (Herdado de HotSpot)
NavigateUrl	Obtém ou define a URL para a qual navegar quando um HotSpot objeto é clicado. (Herdado de HotSpot)
PostBackValue	Obtém ou define o nome do HotSpot objeto a ser passado nos dados do evento quando o HotSpot clique é clicado. (Herdado de HotSpot)
Right	Obtém ou define a coordenada x do lado direito da região retangular definida por esse RectangleHotSpot objeto.
TabIndex	Obtém ou define o índice de tabulação da HotSpot região. (Herdado de HotSpot)
Target	Obtém ou define a janela de destino ou o quadro no qual exibir o conteúdo da página da Web vinculado quando um HotSpot objeto 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 esse RectangleHotSpot objeto.
ViewState	Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um HotSpot objeto em várias solicitações para a mesma página. (Herdado de HotSpot)

Métodos

Nome	Description
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 -and y do canto superior esquerdo de um RectangleHotSpot objeto 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 HotSpot estado de exibição salvo anteriormente do objeto no objeto. (Herdado de HotSpot)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
SaveViewState()	Salva as alterações no HotSpot estado de exibição do objeto desde o momento em que a página foi postada novamente no servidor. (Herdado de HotSpot)
ToString()	Retorna a String representação dessa instância de um HotSpot objeto. (Herdado de HotSpot)
TrackViewState()	Faz com que o HotSpot objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas no objeto do StateBag objeto. Esse objeto é acessível por meio da ViewState propriedade. (Herdado de HotSpot)

Implantações explícitas de interface

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

Aplica-se a

Confira também

Comentários

Esta página foi útil?

Partilhar via

RectangleHotSpot Classe

Definição

Exemplos

Comentários

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Aplica-se a

Confira também

Comentários