HotSpotMode Enumeração

Definição

Obtém ou define os comportamentos de um objeto HotSpot em um controle ImageMap quando se clica em HotSpot.

public enum HotSpotMode
Herança
HotSpotMode

Campos

Inactive 3

O HotSpot não tem nenhum comportamento.

Navigate 1

O HotSpot navega para uma URL.

NotSet 0

O HotSpot usa o comportamento definido pelo controle ImageMap, propriedade HotSpotMode. Se o controle ImageMap não definir o comportamento, o objeto HotSpot navegará para uma URL.

PostBack 2

O HotSpot gera um postback para o servidor.

Exemplos

O exemplo de código a seguir demonstra como usar os HotSpotMode valores de enumeração para definir a ImageMap.HotSpotMode propriedade . A página contém um ImageMap controle que contém dois RectangleHotSpot objetos. A ImageMap.HotSpotMode propriedade é definida HotSpotMode.PostBackcomo , o que faz com que a página seja postada novamente no servidor sempre que um usuário clica em uma das regiões de ponto de acesso. A HotSpotMode propriedade não é definida em nenhum dos RectangleHotSpot objetos porque eles obtêm seu comportamento da ImageMap.HotSpotMode propriedade . Para que este exemplo funcione corretamente, você deve fornecer sua própria imagem para a ImageUrl propriedade e atualizar o caminho para a imagem adequadamente para que o aplicativo possa localizá-la.

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

Comentários

A HotSpotMode enumeração representa os comportamentos que você pode aplicar a um HotSpot objeto dentro de um ImageMap controle . As ImageMap.HotSpotMode propriedades e HotSpot.HotSpotMode usam esses valores de enumeração para definir o comportamento de um HotSpot objeto quando ele é clicado. Se ambas as propriedades forem definidas, a HotSpot.HotSpotMode propriedade especificada em cada objeto individual HotSpot terá precedência sobre a ImageMap.HotSpotMode propriedade no controle .

Se você especificar HotSpotMode.NotSet para a HotSpot.HotSpotMode propriedade de um objeto individualHotSpot, o obterá seu HotSpot comportamento da propriedade do ImageMap.HotSpotMode controle recipienteImageMap. Nesse cenário, se a ImageMap propriedade do HotSpotMode controle for NotSet ou nenhum valor for especificado, o comportamento padrão será navegar até uma URL.

Nota

Se o comportamento de um ImageMap controle não for especificado usando a ImageMap.HotSpotMode propriedade ou a HotSpot.HotSpotMode propriedade nos HotSpot objetos que ele contém, por padrão, o comportamento será HotSpotMode.Navigate. Além disso, se as HotSpot.HotSpotMode propriedades nos HotSpot objetos que um ImageMap controle contém forem definidas HotSpotMode.NotSet como e nenhum valor for especificado para a ImageMap.HotSpotMode propriedade , o comportamento padrão será HotSpotMode.Navigate.

Se você especificar HotSpotMode.Navigate para a ImageMap.HotSpotMode propriedade ou a HotSpot.HotSpotMode propriedade , a página navegará até uma URL quando o HotSpot for clicado. Use a Image.NavigateUrl propriedade ou HotSpot.NavigateUrl para especificar a URL para a qual navegar.

Se você especificar HotSpotMode.PostBack para a ImageMap.HotSpotMode propriedade ou a HotSpot.HotSpotMode propriedade , a página gerará um postback para o servidor quando o HotSpot for clicado. Use a PostBackValue propriedade para especificar um nome para o HotSpot objeto . Esse nome será passado nos dados do ImageMapEventArgs evento quando o evento de postback ocorrer. Quando um postback HotSpot é clicado, o Click evento é gerado. Para controlar programaticamente as ações executadas quando um postback HotSpot é clicado, forneça um manipulador de eventos para o Click evento.

Se você especificar HotSpotMode.Inactive para a HotSpot.HotSpotMode propriedade , o HotSpot objeto não terá nenhum comportamento quando ele for clicado. Você pode usar esse valor para criar um ponto de acesso inativo em um ponto de acesso ativo maior. Essa opção é fornecida para permitir que você crie zonas de ponto de acesso mais complexas dentro de um ImageMap controle.

Para criar uma área inativa dentro de um ponto de acesso ativo, você deve especificar o ponto de acesso inativo antes do ativo no ImageMap controle. Por exemplo, o seguinte ImageMap define um anel ativo especificando um ponto de acesso circular circular inativo em um ponto de acesso 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>  

Aplica-se a

Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também