ImageMap.HotSpotMode Propiedad

  • Referencia

Definición

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

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

public:
 virtual property System::Web::UI::WebControls::HotSpotMode HotSpotMode { System::Web::UI::WebControls::HotSpotMode get(); void set(System::Web::UI::WebControls::HotSpotMode value); };
public virtual System.Web.UI.WebControls.HotSpotMode HotSpotMode { get; set; }
member this.HotSpotMode : System.Web.UI.WebControls.HotSpotMode with get, set
Public Overridable Property HotSpotMode As HotSpotMode

Valor de propiedad

HotSpotMode

Uno de los valores de enumeración de HotSpotMode. De manera predeterminada, es NotSet.

Excepciones

ArgumentOutOfRangeException

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

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. La HotSpotMode propiedad no se establece en cada uno 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

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

Elemento Descripción
Inactive El HotSpot objeto no tiene ningún comportamiento.
NotSet El HotSpot objeto usa el comportamiento establecido por la ImageMap propiedad del HotSpotMode control. Si el ImageMap control no define el comportamiento, todos los HotSpot objetos navegan a una dirección URL.
Navigate Los HotSpot objetos navegan a una dirección URL.
PostBack Los HotSpot objetos generan un postback en el servidor.

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

Al establecer la HotSpotMode propiedad del ImageMap control, tenga en cuenta que los HotSpotMode.NotSet valores y HotSpotMode.Navigate tienen el mismo comportamiento: ambos navegan a una dirección URL. Cuando se especifica HotSpotMode.NotSet para la HotSpot.HotSpotMode propiedad de un objeto individual HotSpot , que HotSpot determina su comportamiento a partir del valor de la HotSpotMode propiedad del ImageMap control.

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

Si especifica HotSpotMode.PostBack para la ImageMap.HotSpotMode propiedad , la página genera un postback en el servidor cuando se hace clic en .HotSpot Utilice la PostBackValue propiedad para especificar el nombre de la región de acceso frecuente. Este nombre se pasará en los datos del ImageMapEventArgs evento cuando se produzca un 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 activa antes de la zona activa en el 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>

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

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

Nota

Si la propiedad de un ImageMap control o la HotSpot.HotSpotMode propiedad de cualquiera de los HotSpot objetos que contiene se establece en o no se establece HotSpotMode.NotSet en un valor, de forma predeterminada el comportamiento es HotSpotMode.NavigateImageMap.HotSpotMode .

Se aplica a

Consulte también