Compartir vía


RectangleHotSpot Clase

Definición

Define una región de zona activa rectangular en un control ImageMap. Esta clase no puede heredarse.

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
Herencia
RectangleHotSpot

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear mediante declaración un ImageMap control que contiene dos RectangleHotSpot objetos. La ImageMap.HotSpotMode propiedad se establece HotSpotMode.PostBacken , lo que hace que la página vuelva a publicar en el servidor cada vez que un usuario haga clic en una de las regiones de acceso frecuente. Cada vez que el usuario hace clic en uno de los RectangleHotSpot objetos , GetCoordinates se llama al método y se muestran las coordenadas de la zona activa seleccionada al usuario. Para que este ejemplo funcione correctamente, debe proporcionar su propia imagen para la ImageUrl propiedad y actualizar la ruta de acceso a la imagen correctamente para que la aplicación pueda localizarla.

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

Comentarios

Esta clase define una región de acceso frecuente rectangular en un ImageMap control . Para definir la región del RectangleHotSpot objeto, establezca la Left propiedad en el valor que representa la coordenada x de la esquina superior izquierda de la región rectangular. Establezca la Top propiedad en el valor que representa la coordenada y de la esquina superior izquierda de la región rectangular. Establezca la Right propiedad en el valor que representa la coordenada x de la esquina inferior derecha de la región rectangular. Establezca la Bottom propiedad en el valor que representa la coordenada y de la esquina inferior derecha de la región rectangular.

Cuando se hace clic en un RectangleHotSpot control, la página navega a una dirección URL, genera una publicación de vuelta al servidor o no hace nada. La HotSpotMode propiedad especifica este comportamiento. Para navegar a una dirección URL, establezca la HotSpotMode propiedad HotSpotMode.Navigate en y use la NavigateUrl propiedad para especificar la dirección URL a la que navegar. Para volver a publicar en el servidor, establezca la HotSpotMode propiedad HotSpotMode.PostBack en y use la PostBackValue propiedad para especificar un nombre para el RectangleHotSpot objeto. Este nombre se pasará en los datos del ImageMapEventArgs evento cuando se haga clic en .RectangleHotSpot . Si desea que el HotSpot objeto no tenga ningún comportamiento, establezca la HotSpotMode propiedad HotSpotMode.Inactiveen .

Constructores

RectangleHotSpot()

Inicializa una nueva instancia de la clase RectangleHotSpot.

Propiedades

AccessKey

Obtiene o establece la tecla de acceso que permite navegar rápidamente a la región HotSpot.

(Heredado de HotSpot)
AlternateText

Obtiene o establece el texto alternativo para mostrar en un objeto HotSpot de un control ImageMap cuando la imagen no está disponible o se representa en un explorador que no admite imágenes.

(Heredado de HotSpot)
Bottom

Obtiene o establece la coordenada Y del lado inferior de la región rectangular definida por este objeto RectangleHotSpot.

HotSpotMode

Especifica o establece el comportamiento de un objeto HotSpot en un control ImageMap cuando se hace clic en HotSpot.

(Heredado de HotSpot)
IsTrackingViewState

Obtiene un valor que indica si el objeto HotSpot realiza el seguimiento de los cambios de su estado de vista.

(Heredado de HotSpot)
Left

Obtiene o establece la coordenada X del lado izquierdo de la región rectangular definida por este objeto RectangleHotSpot.

MarkupName

Cuando se reemplaza en una clase derivada, obtiene la representación de cadena para la forma del objeto HotSpot.

(Heredado de HotSpot)
NavigateUrl

Obtiene o establece la dirección URL de destino cuando se hace clic en un objeto HotSpot.

(Heredado de HotSpot)
PostBackValue

Obtiene o establece el nombre del objeto HotSpot que se pasará en los datos de evento cuando se haga clic en HotSpot.

(Heredado de HotSpot)
Right

Obtiene o establece la coordenada X del lado derecho de la región rectangular definida por este objeto RectangleHotSpot.

TabIndex

Obtiene o establece el índice de tabulación de la región HotSpot.

(Heredado de HotSpot)
Target

Obtiene o establece la ventana o el marco de destino donde debe mostrarse el contenido de la página Web a la que se vincula al hacer clic en un objeto HotSpot que navegue a una dirección URL.

(Heredado de HotSpot)
Top

Obtiene o establece la coordenada Y del lado superior de la región rectangular definida por este objeto RectangleHotSpot.

ViewState

Obtiene un diccionario con información de estado que permite guardar y restaurar el estado de vista de un objeto HotSpot en las distintas solicitudes de la misma página.

(Heredado de HotSpot)

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetCoordinates()

Devuelve una cadena que representa las coordenadas X e Y de la esquina superior izquierda de un objeto RectangleHotSpot y las coordenadas X e Y de la esquina inferior derecha.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
LoadViewState(Object)

Restaura el estado de vista previamente guardado del objeto HotSpot al objeto.

(Heredado de HotSpot)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
SaveViewState()

Guarda los cambios realizados en el estado de la vista del objeto HotSpot desde el momento en que se devolvió la página al servidor.

(Heredado de HotSpot)
ToString()

Devuelve la representación String de esta instancia de un objeto HotSpot.

(Heredado de HotSpot)
TrackViewState()

Hace que el objeto HotSpot efectúe el seguimiento de los cambios de su estado de vista a fin de que se puedan almacenar en su objeto StateBag. Este objeto es accesible a través de la propiedad ViewState.

(Heredado de HotSpot)

Implementaciones de interfaz explícitas

IStateManager.IsTrackingViewState

Obtiene un valor que indica si el objeto HotSpot realiza el seguimiento de los cambios de su estado de vista.

(Heredado de HotSpot)
IStateManager.LoadViewState(Object)

Restaura el estado de vista previamente guardado del objeto HotSpot al objeto.

(Heredado de HotSpot)
IStateManager.SaveViewState()

Guarda los cambios realizados en el estado de la vista del objeto HotSpot desde la última vez que se devolvió la página al servidor.

(Heredado de HotSpot)
IStateManager.TrackViewState()

Indica a la región HotSpot que efectúe el seguimiento de los cambios de su estado de vista.

(Heredado de HotSpot)

Se aplica a

Consulte también