HotSpotMode Enumeración
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í.
public enum class HotSpotModepublic enum HotSpotModetype HotSpotMode = Public Enum HotSpotMode- Herencia
Campos
| Inactive | 3 | HotSpot no tiene comportamiento. |
| Navigate | 1 | HotSpot navega a una dirección URL. |
| NotSet | 0 | HotSpot utiliza el comportamiento establecido por la propiedad ImageMap del control HotSpotMode. Si el control ImageMap no define el comportamiento, el objeto HotSpot navega a una dirección URL. |
| PostBack | 2 | El objeto HotSpot genera un postback al servidor. |
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar los HotSpotMode valores de enumeración para establecer la ImageMap.HotSpotMode propiedad . La página contiene 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. La HotSpotMode propiedad no se establece en ninguno de los RectangleHotSpot objetos porque obtienen su comportamiento de la ImageMap.HotSpotMode propiedad . 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)
{
// When a user clicks the "Yes" hot spot,
// display the hot spot's value.
if (e.PostBackValue == "Yes")
Message1.Text = "You selected " + e.PostBackValue + ".";
else if (e.PostBackValue == "No")
// When a user clicks the "No" hot spot,
// display the hot spot's value.
Message1.Text = "You selected " + e.PostBackValue + ".";
else
Message1.Text = "You did not click a valid hot spot region.";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>ImageMap.HotSpotMode Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageMap.HotSpotMode Example</h3>
<!--The RectangleHotSpot objects have the post back
behavior specified by the HotSpotMode
property on the ImageMap control.-->
<asp:imagemap id="Vote"
imageurl="Images/VoteImage.jpg"
alternatetext="Voting choices"
hotspotmode="PostBack"
onclick="VoteMap_Clicked"
runat="Server">
<asp:RectangleHotSpot
top="0"
left="0"
bottom="354"
right="250"
postbackvalue="Yes"
alternatetext="Vote yes">
</asp:RectangleHotSpot>
<asp:RectangleHotSpot
top="0"
left="251"
bottom="354"
right="500"
postbackvalue="No"
alternatetext="Vote no">
</asp:RectangleHotSpot>
</asp:imagemap>
<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)
' When a user clicks the "Yes" hot spot,
' display the hot spot's value.
If (e.PostBackValue = "Yes") Then
Message1.Text = "You selected " & e.PostBackValue & "."
' When a user clicks the "No" hot spot,
' display the hot spot's value.
ElseIf (e.PostBackValue = "No") Then
Message1.Text = "You selected " & e.PostBackValue & "."
Else
Message1.Text = "You did not click a valid hot spot region."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>ImageMap.HotSpotMode Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageMap.HotSpotMode Example</h3>
<!--The RectangleHotSpot objects have the post back
behavior specified by the HotSpotMode
property on the ImageMap control.-->
<asp:imagemap id="Vote"
imageurl="Images/VoteImage.jpg"
alternatetext="Voting choices"
hotspotmode="PostBack"
onclick="VoteMap_Clicked"
runat="Server">
<asp:RectangleHotSpot
top="0"
left="0"
bottom="354"
right="250"
postbackvalue="Yes"
alternatetext="Vote yes">
</asp:RectangleHotSpot>
<asp:RectangleHotSpot
top="0"
left="251"
bottom="354"
right="500"
postbackvalue="No"
alternatetext="Vote no">
</asp:RectangleHotSpot>
</asp:imagemap>
<br />
<asp:label id="Message1"
runat="Server">
</asp:label>
</form>
</body>
</html>
Comentarios
La HotSpotMode enumeración representa los comportamientos que se pueden aplicar a un HotSpot objeto dentro de un ImageMap control . Las ImageMap.HotSpotMode propiedades y HotSpot.HotSpotMode usan estos valores de enumeración para establecer el comportamiento de un HotSpot objeto cuando se hace clic en él. Si se establecen ambas propiedades, la HotSpot.HotSpotMode propiedad especificada en cada objeto individual HotSpot tiene prioridad sobre la ImageMap.HotSpotMode propiedad del control.
Si especifica para la HotSpot.HotSpotMode propiedad de un objeto individualHotSpot, HotSpot obtiene su comportamiento de la propiedad del ImageMap.HotSpotMode control contenedorImageMap.HotSpotMode.NotSet En este escenario, si la ImageMap propiedad del HotSpotMode control es NotSet o no se especifica ningún valor, el comportamiento predeterminado es navegar a una dirección URL.
Nota
Si no se especifica el comportamiento de un ImageMap control mediante la ImageMap.HotSpotMode propiedad o la HotSpot.HotSpotMode propiedad de los HotSpot objetos que contiene, de forma predeterminada, el comportamiento es HotSpotMode.Navigate. Además, si las HotSpot.HotSpotMode propiedades de los HotSpot objetos que contiene un ImageMap control se establecen HotSpotMode.NotSet en y no se especifica ningún valor para la ImageMap.HotSpotMode propiedad , el comportamiento predeterminado es HotSpotMode.Navigate.
Si especifica HotSpotMode.Navigate para la ImageMap.HotSpotMode propiedad o la HotSpot.HotSpotMode propiedad , la página navega a una dirección URL cuando HotSpot se hace clic en . Use o Image.NavigateUrl la HotSpot.NavigateUrl propiedad para especificar la dirección URL a la que navegar.
Si especifica HotSpotMode.PostBack para la ImageMap.HotSpotMode propiedad o la HotSpot.HotSpotMode propiedad , la página genera un postback al servidor cuando se hace clic en .HotSpot Utilice la PostBackValue propiedad para especificar un nombre para el HotSpot objeto . Este nombre se pasará en los datos del ImageMapEventArgs evento cuando se produzca el evento de postback. Cuando se hace clic en un postback HotSpot , se genera el Click evento . Para controlar mediante programación las acciones realizadas cuando se hace clic en un postback HotSpot , proporcione un controlador de eventos para el Click evento.
Si especifica HotSpotMode.Inactive para la HotSpot.HotSpotMode propiedad , el HotSpot objeto no tiene ningún comportamiento cuando se hace clic en ella. Puede usar este valor para crear una zona activa inactiva dentro de una zona activa más grande. Esta opción se proporciona para permitirle crear zonas de zonas activas más complejas dentro de un ImageMap control.
Para crear un área inactiva dentro de una zona activa activa, debe especificar la zona activa inactiva antes de la activa del ImageMap control. Por ejemplo, lo siguiente ImageMap define un anillo activo especificando una zona activa activa activa dentro de una zona activa activa más grande:
<asp:ImageMap ID="SaturnImage"
ImageUrl="~/saturn.PNG"
runat="server" OnClick="SaturnImage_Click">
<asp:CircleHotSpot AlternateText="planet" HotSpotMode=PostBack
PostBackValue="planet" Radius=40 X=100 Y=100 />
<asp:CircleHotSpot HotSpotMode=Inactive
Radius=60 X=100 Y=100 />
<asp:CircleHotSpot AlternateText="rings" HotSpotMode=PostBack
PostBackValue="rings" Radius=80 X=100 Y=100 />
</asp:ImageMap>
