RectangleHotSpot Clase

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Define una región de zona activa rectangular en un ImageMap control . 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: Object

HotSpot
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, se llama al GetCoordinates 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 zona activa 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. Conjunto de 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 ir 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 RectangleHotSpot se haga clic en . . Si desea que el HotSpot objeto no tenga ningún comportamiento, establezca la HotSpotMode propiedad HotSpotMode.Inactiveen .

Constructores

Nombre	Description
RectangleHotSpot()	Inicializa una nueva instancia de la clase RectangleHotSpot.

Propiedades

Nombre	Description
AccessKey	Obtiene o establece la clave de acceso que le permite navegar rápidamente a la HotSpot región. (Heredado de HotSpot)
AlternateText	Obtiene o establece el texto alternativo que se va a mostrar para un objeto en un HotSpot ImageMap control 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 RectangleHotSpot objeto.
HotSpotMode	Obtiene o establece el comportamiento de un objeto en un HotSpot ImageMap control cuando HotSpot se hace clic en . (Heredado de HotSpot)
IsTrackingViewState	Obtiene un valor que indica si el HotSpot objeto está realizando el seguimiento de los cambios de estado de vista. (Heredado de HotSpot)
Left	Obtiene o establece la coordenada x del lado izquierdo de la región rectangular definida por este RectangleHotSpot objeto.
MarkupName	Cuando se reemplaza en una clase derivada, obtiene la representación de cadena de la HotSpot forma del objeto. (Heredado de HotSpot)
NavigateUrl	Obtiene o establece la dirección URL a la que navegar cuando se hace clic en un HotSpot objeto. (Heredado de HotSpot)
PostBackValue	Obtiene o establece el nombre del HotSpot objeto que se va a pasar en los datos del evento cuando HotSpot se hace clic en . (Heredado de HotSpot)
Right	Obtiene o establece la coordenada x del lado derecho de la región rectangular definida por este RectangleHotSpot objeto.
TabIndex	Obtiene o establece el índice de tabulación de la HotSpot región. (Heredado de HotSpot)
Target	Obtiene o establece la ventana o marco de destino en el que se va a mostrar el contenido de la página web vinculado cuando se hace clic en un HotSpot objeto que navega 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 RectangleHotSpot objeto.
ViewState	Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un HotSpot objeto en varias solicitudes para la misma página. (Heredado de HotSpot)

Métodos

Nombre	Description
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetCoordinates()	Devuelve una cadena que representa las coordenadas x -and y de la esquina superior izquierda de un RectangleHotSpot objeto y las coordenadas x e y de su esquina inferior derecha.
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
LoadViewState(Object)	Restaura el HotSpot estado de vista guardado anteriormente del objeto en el objeto . (Heredado de HotSpot)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
SaveViewState()	Guarda los cambios en el HotSpot estado de vista del objeto desde el momento en que se devolvió la página al servidor. (Heredado de HotSpot)
ToString()	Devuelve la String representación de esta instancia de un HotSpot objeto . (Heredado de HotSpot)
TrackViewState()	Hace que el HotSpot objeto realice un seguimiento de los cambios en su estado de vista para que se puedan almacenar en el objeto del StateBag objeto. Este objeto es accesible a través de la ViewState propiedad . (Heredado de HotSpot)

Implementaciones de interfaz explícitas

Nombre	Description
IStateManager.IsTrackingViewState	Obtiene un valor que indica si el HotSpot objeto está realizando el seguimiento de los cambios de estado de vista. (Heredado de HotSpot)
IStateManager.LoadViewState(Object)	Restaura el HotSpot estado de vista guardado anteriormente del objeto en el objeto . (Heredado de HotSpot)
IStateManager.SaveViewState()	Guarda los cambios en el HotSpot estado de vista del objeto desde la última vez que la página se devolvió al servidor. (Heredado de HotSpot)
IStateManager.TrackViewState()	Indica a la HotSpot región que realice un seguimiento de los cambios en su estado de vista. (Heredado de HotSpot)

Se aplica a

Consulte también

Comentarios

Resultoulle útil esta páxina?

Compartir por

RectangleHotSpot Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

Comentarios