RectangleHotSpot Clase
Definición
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 control ImageMap. Esta clase no puede heredarse.
public ref class RectangleHotSpot sealed : System::Web::UI::WebControls::HotSpotpublic sealed class RectangleHotSpot : System.Web.UI.WebControls.HotSpottype RectangleHotSpot = class
inherit HotSpotPublic NotInheritable Class RectangleHotSpot
Inherits HotSpot- Herencia
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) |