Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

ImageMap.HotSpotMode (Propiedad)

Obtiene o establece el comportamiento predeterminado para los objetos HotSpot de un control ImageMap cuando se hace clic en los objetos HotSpot.

Espacio de nombres:  System.Web.UI.WebControls
Ensamblado:  System.Web (en System.Web.dll)

public virtual HotSpotMode HotSpotMode { get; set; }
<asp:ImageMap HotSpotMode="HotSpotMode" />

Valor de propiedad

Tipo: System.Web.UI.WebControls.HotSpotMode
Uno de los valores de la enumeración HotSpotMode. El tipo predeterminado es NotSet.

ExcepciónCondición
ArgumentOutOfRangeException

El tipo especificado no se corresponde con ninguno de los valores de la enumeración HotSpotMode.

Utilice la propiedad HotSpotMode para especificar el comportamiento de clic predeterminado de los objetos HotSpot dentro de un control ImageMap. Esta propiedad se establece mediante uno de los valores de enumeración HotSpotMode. En la siguiente tabla se enumeran los posibles valores.

Elemento

Descripción

Inactive

El objeto HotSpot no tiene ningún comportamiento.

NotSet

El objeto HotSpot utiliza el comportamiento establecido por la propiedad HotSpotMode del control ImageMap. Si el control ImageMap no define el comportamiento, todos los objetos HotSpot navegan a una dirección URL.

Navigate

Los objetos HotSpot navegan a una dirección URL.

PostBack

Los objetos HotSpot generan una devolución de datos al servidor.

Puede especificar el comportamiento de un objeto HotSpot mediante la propiedad ImageMap.HotSpotMode del control ImageMap o la propiedad HotSpot.HotSpotMode de cada objeto HotSpot individual. Si se establecen ambas propiedades, la propiedad HotSpot.HotSpotMode especificada en cada objeto HotSpot individual tiene prioridad sobre la propiedad ImageMap.HotSpotMode del control ImageMap.

Cuando establezca la propiedad HotSpotMode del control ImageMap, observe que los valores HotSpotMode.NotSet y HotSpotMode.Navigate tienen el mismo comportamiento: los dos navegan a una dirección URL. Cuando se especifica HotSpotMode.NotSet para la propiedad HotSpot.HotSpotMode de un objeto HotSpot individual, ese objeto HotSpot determina su comportamiento en función del valor de la propiedad HotSpotMode del control ImageMap.

Si se especifica HotSpotMode.Navigate para la propiedad ImageMap.HotSpotMode, la página navega a una dirección URL cuando se hace clic en el objeto HotSpot. Utilice la propiedad NavigateUrl para especificar la URL de destino.

Si se especifica HotSpotMode.PostBack para la propiedad ImageMap.HotSpotMode, la página genera una devolución de datos al servidor cuando se hace clic en el objeto HotSpot. Utilice la propiedad PostBackValue para especificar el nombre de la región de zona activa. Este nombre se pasa en los datos del evento ImageMapEventArgs cuando se produce un evento de devolución de datos. Cuando se hace clic en una devolución de datos HotSpot, se provoca el evento Click. Para controlar mediante programación las acciones que se realizarán cuando se haga clic en una devolución de datos HotSpot, proporcione un controlador de eventos para el evento Click.

Si especifica HotSpotMode.Inactive para la propiedad HotSpot.HotSpotMode, el objeto HotSpot no tiene ningún comportamiento cuando se hace clic en él. Puede utilizar este valor para crear una zona activa inactiva dentro de una zona activa más grande. Esta opción se proporciona para poder crear zonas activas más complejas dentro de un control ImageMap.

Para crear una zona inactiva dentro de una zona activa activa, debe especificar la zona activa inactiva antes de la zona activa activa en el control ImageMap. Por ejemplo, el objeto ImageMap siguiente define un anillo activo especificando una zona activa circular inactiva dentro de una zona activa circular 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>

Para hacer que todos los objetos HotSpot de un control ImageMap tengan el mismo comportamiento, utilice la propiedad HotSpotMode del control ImageMap para especificar el comportamiento. A continuación, establezca la propiedad HotSpotMode de cada objeto HotSpot individual en HotSpotMode.NotSet o no especifique ningún valor para la propiedad HotSpot.HotSpotMode.

Para especificar diferentes comportamientos para los objetos HotSpot de un control ImageMap, establezca la propiedad HotSpot.HotSpotMode de cada objeto HotSpot individual en HotSpotMode.Navigate, HotSpotMode.PostBack o HotSpotMode.Inactive.

NotaNota

Si la propiedad ImageMap.HotSpotMode de un control ImageMap o la propiedad HotSpot.HotSpotMode de cualquiera de los objetos HotSpot que contiene se establece en HotSpotMode.NotSet o no se establece en ningún valor, el comportamiento predeterminado es HotSpotMode.Navigate.

En el ejemplo de código siguiente se muestra cómo se crea mediante declaración un control ImageMap que contiene dos objetos RectangleHotSpot. La propiedad ImageMap.HotSpotMode se establece en HotSpotMode.PostBack, haciendo que la página devuelva datos al servidor cada vez que un usuario haga clic en una de las áreas de la zona activa. La propiedad HotSpotMode no se establece en cada uno de los objetos RectangleHotSpot, porque reciben su comportamiento de la propiedad ImageMap.HotSpotMode. Para que este ejemplo funcione correctamente, deberá proporcionar su propia imagen a la propiedad ImageUrl y actualizar correctamente la ruta de acceso a la imagen 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>


.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Mostrar: