Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Enumeração HotSpotMode

Especifica os comportamentos de um HotSpot objeto em um ImageMap controlar quando o HotSpot é clicado.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

public enum HotSpotMode

Nome do membroDescrição
NotSetThe HotSpot usa o comportamento conjunto pela ImageMap do controle HotSpotMode propriedade. Se o ImageMap controle não define o comportamento do HotSpot objeto navega para um URL.
Navigate The HotSpot navega para um URL.
PostBack The HotSpot gera um postback para o servidor.
Inactive The HotSpot não tem qualquer comportamento.

The HotSpotMode enumeração representa os comportamentos que podem ser aplicadas a um HotSpot objeto dentro de um ImageMap controle. The ImageMap.HotSpotMode e o HotSpot.HotSpotMode propriedades usa esses valores de enumeração para conjunto o comportamento de um HotSpot objeto quando ele for clicado. Se ambas as propriedades estiverem conjunto, a HotSpot.HotSpotMode propriedade especificada em cada indivíduo HotSpot objeto tem precedência sobre o ImageMap.HotSpotMode propriedade no controle.

Se você especificar HotSpotMode.NotSet para o HotSpot.HotSpotMode propriedade de um indivíduo HotSpot objeto, o HotSpot obtém seu comportamento de que o contém ImageMap do controle ImageMap.HotSpotMode propriedade. Nesse cenário, se o ImageMap do controle HotSpotMode propriedade está NotSet ou nenhum valor for especificado, o comportamento padrão é navegar até uma URL.

ObservaçãoObservação:

Se um ImageMap comportamento do controle não for especificado, usando o ImageMap.HotSpotMode propriedade ou o HotSpot.HotSpotMode propriedade no HotSpot objetos que ela contém, por padrão que o comportamento é HotSpotMode.Navigate. Além disso, se o HotSpot.HotSpotMode nas propriedades de HotSpot objetos que um ImageMap controle contém são conjunto para HotSpotMode.NotSet e nenhum valor for especificado para o ImageMap.HotSpotMode propriedade, o comportamento padrão é HotSpotMode.Navigate.

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

Se você especificar HotSpotMode.PostBack para cada uma a ImageMap.HotSpotMode propriedade ou o HotSpot.HotSpotMode propriedade, a página gera um postback para o servidor quando o HotSpot é clicado. Use o PostBackValue propriedade para especificar um nome para o HotSpot objeto. Esse nome será passada no ImageMapEventArgs dados de evento quando ocorre o evento postback. 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 o HotSpot.HotSpotMode propriedade, o HotSpot objeto não tem qualquer comportamento quando é clicado. Você pode usar esse valor para criar um ponto de acesso inativo dentro de um ponto de acesso ativo maior.Esta opção é fornecida para permitir que você crie zonas de ponto de acesso mais complexas dentro de um ImageMap controle.

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

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

O exemplo de código a seguir demonstra como usar o HotSpotMode valores de enumeração para conjunto o ImageMap.HotSpotMode propriedade. A página contém um ImageMap controle que contém dois RectangleHotSpot objetos. The ImageMap.HotSpotMode propriedade é conjunto para HotSpotMode.PostBack, que faz com que a página enviar novamente para o servidor sempre que um usuário clica em uma das regiões de ponto de acesso. The HotSpotMode propriedade não está conjunto em ambas as RectangleHotSpot objetos porque eles obtêm seus comportamentos da ImageMap.HotSpotMode propriedade. Para esse exemplo funcione corretamente, você deve fornecer sua própria imagem para o ImageUrl propriedade e atualizar o caminho para a imagem corretamente para que o aplicativo possa localizá-lo.

<%@ 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 + ".";

    elseif (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

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0
Mostrar: