HotSpot.HotSpotMode Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define o comportamento de um objeto HotSpot em um controle ImageMap quando se clica em 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 da propriedade

HotSpotMode

Um dos valores de enumeração HotSpotMode. O padrão é Default.

Exceções

ArgumentOutOfRangeException

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

Comentários

Use a HotSpotMode propriedade para especificar o comportamento de um HotSpot objeto em um ImageMap controle quando o HotSpot for clicado. Essa propriedade é definida usando um dos HotSpotMode valores de enumeração. A tabela a seguir lista os valores possíveis.

Valor Descrição
NotSet O HotSpot usa o comportamento definido pelo controle ImageMap, propriedade HotSpotMode. Se o ImageMap controle não definir o comportamento, os HotSpot objetos navegarão para uma URL.
Inactive O HotSpot não tem nenhum comportamento.
Navigate O HotSpot navega para uma URL.
PostBack O HotSpot gera um postback para o servidor.

Você pode especificar HotSpot o HotSpotMode comportamento na propriedade do controle ou na HotSpotMode propriedade de cada objeto individual HotSpot . Se ambas as propriedades forem definidas, a HotSpotMode propriedade especificada em cada objeto individual HotSpot terá precedência sobre a HotSpotMode propriedade no ImageMap controle .

Se você especificar HotSpotMode.NotSet para a HotSpotMode propriedade de um objeto individualHotSpot, o obterá seu HotSpot comportamento da propriedade do HotSpotMode controle que contémImageMap. Nesse cenário, se a ImageMap propriedade do HotSpotMode controle não estiver definida como um valor ou estiver definida como HotSpotMode.NotSet, o comportamento padrão será navegar para uma URL.

Se você especificar HotSpotMode.Navigate para a HotSpotMode propriedade de um HotSpot objeto, o HotSpot objeto navegará para uma URL quando a região do ponto de acesso for clicada. Use a NavigateUrl propriedade para especificar a URL para a qual navegar.

Se você especificar HotSpotMode.PostBack para a HotSpotMode propriedade de um HotSpot objeto , o HotSpot objeto gerará uma postagem de volta para o servidor quando o HotSpot for clicado. Use a PostBackValue propriedade para especificar um nome para o HotSpot. Esse nome será passado nos dados do ImageMapEventArgs evento em quando ocorrer um evento de 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.

Para fazer com que todos os HotSpot objetos em um ImageMap controle tenham o mesmo comportamento, defina a HotSpot.HotSpotMode propriedade em cada objeto HotSpotMode.NotSet individual HotSpot como ou não especifique um valor para a HotSpot.HotSpotMode propriedade .

Para especificar comportamentos diferentes para HotSpot objetos em um ImageMap controle, defina a HotSpot.HotSpotMode propriedade em cada objeto individual HotSpot como HotSpotMode.Navigate, HotSpotMode.PostBackou HotSpotMode.Inactive.

Observação

Se a propriedade de um ImageMap controle ou a HotSpot.HotSpotMode propriedade nos HotSpot objetos que ele contém não estiver definida como um valor ou definida HotSpotMode.NotSetcomo , por padrão, o comportamento será HotSpotMode.Navigate.ImageMap.HotSpotMode

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 dentro de 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 ponto de acesso ativo no ImageMap controle. Por exemplo, o seguinte ImageMap define um anel ativo especificando um ponto de acesso circular inativo dentro de 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

Confira também