ImageMap.HotSpotMode Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.dll

Obtém ou define o comportamento padrão dos HotSpot objetos de um ImageMap controlo quando os HotSpot objetos são clicados.

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 Propriedade

HotSpotMode

Um dos HotSpotMode valores de enumeração. A predefinição é NotSet.

Exceções

ArgumentOutOfRangeException

O tipo especificado não é um dos valores de HotSpotMode enumeração.

Exemplos

O exemplo de código seguinte demonstra como criar declarativamente um ImageMap controlo que contenha dois RectangleHotSpot objetos. A ImageMap.HotSpotMode propriedade está definida como HotSpotMode.PostBack, o que faz com que a página volte a publicar no servidor sempre que um utilizador clica numa das regiões de pontos quentes. A HotSpotMode propriedade não está definida em cada um dos RectangleHotSpot objetos porque eles obtêm o seu comportamento dessa ImageMap.HotSpotMode propriedade. Para que este exemplo funcione corretamente, deve fornecer a sua própria imagem para a ImageUrl propriedade e atualizar o caminho da imagem adequadamente para que a aplicação a possa localizar.

<%@ 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>

Observações

Use a HotSpotMode propriedade para especificar o comportamento de clique padrão dos HotSpot objetos dentro de um ImageMap controlo. Esta propriedade é definida usando um dos valores de HotSpotMode enumeração. A tabela seguinte lista os valores possíveis.

Número Description
Inactive O HotSpot objeto não apresenta qualquer comportamento.
NotSet O HotSpot objeto utiliza o comportamento definido pela ImageMap propriedade do HotSpotMode controlo. Se o controlo ImageMap não definir o comportamento, todos os HotSpot objetos navegam para uma URL.
Navigate Os HotSpot objetos navegam até uma URL.
PostBack Os HotSpot objetos geram um postback para o servidor.

Pode especificar o comportamento de um HotSpot objeto usando a ImageMap.HotSpotMode propriedade do ImageMap controlo ou a HotSpot.HotSpotMode propriedade de cada objeto individual HotSpot . Se ambas as propriedades estiverem definidas, a HotSpot.HotSpotMode propriedade especificada em cada objeto individual HotSpot tem precedência sobre a ImageMap.HotSpotMode propriedade no ImageMap controlo.

Ao definir a HotSpotMode propriedade do ImageMap controlo, note que os HotSpotMode.NotSet valores e HotSpotMode.Navigate têm o mesmo comportamento: ambos navegam para uma URL. Quando especificas HotSpotMode.NotSet para a HotSpot.HotSpotMode propriedade de um objeto individual HotSpot , isso HotSpot determina o seu comportamento a partir do valor da HotSpotMode propriedade do ImageMap controlo.

Se especificar HotSpotMode.Navigate para a ImageMap.HotSpotMode propriedade, a página navega até uma URL quando é clicada HotSpot . Use a NavigateUrl propriedade para especificar o URL para onde navegar.

Se especificar HotSpotMode.PostBack para a ImageMap.HotSpotMode propriedade, a página gera um retorno de postback ao servidor quando é clicada HotSpot . Use a PostBackValue propriedade para especificar o nome da região do ponto quente. Este nome será passado nos ImageMapEventArgs dados do evento quando ocorrer um evento de postback. Quando um postback HotSpot é clicado, o Click evento é elevado. Para controlar programaticamente as ações realizadas quando um postback HotSpot é clicado, forneça um gestor de eventos para o Click evento.

Se especificar HotSpotMode.Inactive para a HotSpot.HotSpotMode propriedade, o HotSpot objeto não apresenta qualquer comportamento quando é clicado. Pode usar este valor para criar um ponto quente inativo dentro de um ponto quente ativo maior. Esta opção é disponibilizada para permitir criar zonas de pontos quentes mais complexas dentro de um ImageMap controlo.

Para criar uma área inativa dentro de um ponto quente ativo, deve especificar o ponto quente inativo antes do ponto ativo no ImageMap controlo. Por exemplo, o seguinte ImageMap define um anel ativo especificando um ponto quente circular inativo dentro de um ponto quente circular ativo maior:

<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 fazer com que todos HotSpot os objetos num ImageMap controlo tenham o mesmo comportamento, use a HotSpotMode propriedade do ImageMap controlo para especificar o comportamento. Depois, define a HotSpotMode propriedade de cada objeto individual HotSpot para HotSpotMode.NotSet ou não especifica um valor para essa HotSpot.HotSpotMode propriedade.

Para especificar comportamentos diferentes para HotSpot objetos num ImageMap controlo, defina a HotSpot.HotSpotMode propriedade de cada objeto individual HotSpot para , HotSpotMode.NavigateHotSpotMode.PostBack, ou HotSpotMode.Inactive.

Note

Se a propriedade de um ImageMap controlo ou a HotSpot.HotSpotMode propriedade de qualquer um dos HotSpot objetos que contém estiver definida para HotSpotMode.NotSet ou não definida para um valor, por defeito o comportamento é HotSpotMode.NavigateImageMap.HotSpotMode .

Aplica-se a

Ver também