Esta documentación está archivada y no tiene mantenimiento.

HotSpotMode (Enumeración)

Actualización: noviembre 2007

Especifica los comportamientos de un objeto HotSpot en un control ImageMap cuando se hace clic en HotSpot.

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

public enum HotSpotMode
public enum HotSpotMode
public enum HotSpotMode

Nombre de miembroDescripción
NotSetHotSpot utiliza el comportamiento establecido por la propiedad HotSpotMode del control ImageMap. Si el control ImageMap no define el comportamiento, el objeto HotSpot navega a una dirección URL.
NavigateHotSpot navega a una dirección URL.
PostBackHotSpot genera una devolución de datos al servidor.
InactiveHotSpot no tiene comportamiento.

La enumeración HotSpotMode representa los comportamientos que se pueden aplicar a un objeto HotSpot en un control ImageMap. Las propiedades ImageMap.HotSpotMode y HotSpot.HotSpotMode utilizan estos valores de enumeración para establecer el comportamiento de un objeto HotSpot cuando se hace clic en él. Si se establecen ambas propiedades, la propiedad HotSpot.HotSpotMode especificada en cada objeto HotSpot individual tiene prioridad sobre la propiedad ImageMap.HotSpotMode del control.

Si especifica HotSpotMode.NotSet para la propiedad HotSpot.HotSpotMode de un objeto HotSpot individual, HotSpot toma su comportamiento de la propiedad ImageMap.HotSpotMode del control ImageMap que lo contiene. En este escenario, si la propiedad HotSpotMode del control ImageMap es NotSet o no se especifica ningún valor, el comportamiento predeterminado es navegar a una dirección URL.

26ssbtsz.alert_note(es-es,VS.90).gifNota:

Si no se especifica el comportamiento del control ImageMap mediante la propiedad ImageMap.HotSpotMode o la propiedad HotSpot.HotSpotMode en los objetos HotSpot que contiene, el comportamiento predeterminado es HotSpotMode.Navigate. Además, si las propiedades HotSpot.HotSpotMode de los objetos HotSpot que contiene un control ImageMap se establecen en HotSpotMode.NotSet y no se especifica ningún valor para la propiedad ImageMap.HotSpotMode, el comportamiento predeterminado es HotSpotMode.Navigate.

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

Si especifica HotSpotMode.PostBack para la propiedad ImageMap.HotSpotMode o la propiedad HotSpot.HotSpotMode, la página genera una devolución de datos al servidor cuando se hace clic en HotSpot. Utilice la propiedad PostBackValue para especificar un nombre para el objeto HotSpot. Este nombre se pasará en los datos del evento ImageMapEventArgs cuando se produzca el 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 un área inactiva dentro de una zona activa, debe especificar la zona inactiva antes de la activa en el control ImageMap. Por ejemplo, el 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>

En el ejemplo de código siguiente se muestra cómo utilizar los valores de la enumeración HotSpotMode para establecer la propiedad ImageMap.HotSpotMode. La página contiene un control ImageMap con 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 ninguno de los objetos RectangleHotSpot porque reciben su comportamiento de la propiedad ImageMap.HotSpotMode. Para que este ejemplo funcione correctamente, debe 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>


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0
Mostrar: