RectangleHotSpot Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Define uma região retangular de ponto quente num ImageMap controlo. Esta 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 seguinte demonstra como criar declarativamente um ImageMap controlo que contenha dois RectangleHotSpot objetos. A ImageMap.HotSpotMode propriedade está definida como HotSpotMode.PostBack, o que faz com que a página volte a publicar no servidor sempre que um utilizador clica numa das regiões de pontos quentes. Cada vez que o utilizador clica num dos RectangleHotSpot objetos, o GetCoordinates método é chamado e as coordenadas do ponto quente selecionado são apresentadas ao utilizador. Para que este exemplo funcione corretamente, deve fornecer a sua própria imagem para a ImageUrl propriedade e atualizar o caminho da imagem adequadamente para que a aplicação a possa localizar.

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

Observações

Esta classe define uma região retangular de ponto quente num ImageMap controlo. Para definir a região do RectangleHotSpot objeto, defina a Left propriedade para o valor que representa a coordenada x do canto superior esquerdo da região retangular. Defina a Top propriedade para o valor que representa a coordenada y do canto superior esquerdo da região retangular. Defina a Right propriedade para 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 controlo é clicado, a página navega até uma URL, gera uma publicação de volta ao servidor ou não faz nada. A HotSpotMode propriedade especifica este comportamento. Para navegar até uma URL, defina a HotSpotMode propriedade para HotSpotMode.Navigate e use a NavigateUrl propriedade para especificar a URL a seguir. Para publicar de volta no servidor, defina a HotSpotMode propriedade para HotSpotMode.PostBack e use a PostBackValue propriedade para especificar um nome para o RectangleHotSpot objeto. Este nome será passado nos ImageMapEventArgs dados do evento quando é clicado RectangleHotSpot . . Se quiser que o HotSpot objeto não tenha comportamento, defina a HotSpotMode propriedade para HotSpotMode.Inactive.

Construtores

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

Propriedades

Name	Description
AccessKey	Obtém ou define a chave de acesso que permite navegar rapidamente para a HotSpot região. (Herdado de HotSpot)
AlternateText	Obtém ou define o texto alternativo para mostrar para um HotSpot objeto num ImageMap controlo quando a imagem não está disponível ou é renderizado num navegador que não suporta 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 num ImageMap controlo quando o HotSpot é clicado. (Herdado de HotSpot)
IsTrackingViewState	Obtém um valor que indica se o HotSpot objeto está a acompanhar as suas alterações de estado de visualização. (Herdado de HotSpot)
Left	Obtém ou define a coordenada x do lado esquerdo da região retangular definida por este RectangleHotSpot objeto.
MarkupName	Quando sobrescrito numa classe derivada, obtém-se a representação da cadeia para a HotSpot forma do objeto. (Herdado de HotSpot)
NavigateUrl	Obtém ou define a URL para navegar quando um HotSpot objeto é clicado. (Herdado de HotSpot)
PostBackValue	Recebe ou define o nome do HotSpot objeto a passar nos dados do evento quando é clicado HotSpot . (Herdado de HotSpot)
Right	Obtém ou define a coordenada x do lado direito da região retangular definida por este RectangleHotSpot objeto.
TabIndex	Obtém ou define o índice tab da HotSpot região. (Herdado de HotSpot)
Target	Obtém ou define a janela ou frame-alvo onde mostrar o conteúdo da página Web ligado quando um HotSpot objeto que navega até uma URL é clicado. (Herdado de HotSpot)
Top	Obtém ou define a coordenada y do lado superior da região retangular definida por este RectangleHotSpot objeto.
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um HotSpot objeto através de múltiplos pedidos para a mesma página. (Herdado de HotSpot)

Métodos

Name	Description
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetCoordinates()	Devolve uma cadeia que representa as coordenadas x -and y do canto superior esquerdo de um RectangleHotSpot objeto e as coordenadas x e y do canto inferior direito.
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadViewState(Object)	Restaura o HotSpot estado de visualização previamente guardado do objeto para o objeto. (Herdado de HotSpot)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
SaveViewState()	Guarda as alterações ao estado de HotSpot visualização do objeto desde o momento em que a página foi publicada de volta no servidor. (Herdado de HotSpot)
ToString()	Devolve a String representação desta instância de um HotSpot objeto. (Herdado de HotSpot)
TrackViewState()	Faz com que o HotSpot objeto acompanhe alterações ao seu estado de visualização para que possam ser armazenadas no objeto do StateBag objeto. Este objeto é acessível através da ViewState propriedade. (Herdado de HotSpot)

Implementações de Interface Explícita

Name	Description
IStateManager.IsTrackingViewState	Obtém um valor que indica se o HotSpot objeto está a acompanhar as suas alterações de estado de visualização. (Herdado de HotSpot)
IStateManager.LoadViewState(Object)	Restaura o HotSpot estado de visualização previamente guardado do objeto para o objeto. (Herdado de HotSpot)
IStateManager.SaveViewState()	Guarda as alterações ao estado de HotSpot visualização do objeto desde a última vez que a página foi publicada de volta no servidor. (Herdado de HotSpot)
IStateManager.TrackViewState()	Instrui a HotSpot região a acompanhar as alterações no estado de visualização. (Herdado de HotSpot)

Aplica-se a

Ver também

Comentários

Esta página foi útil?