HotSpotMode Wyliczenie

Definicja

Określa zachowania HotSpot obiektu w kontrolce ImageMap po kliknięciu HotSpot .

public enum class HotSpotMode
public enum HotSpotMode
type HotSpotMode = 
Public Enum HotSpotMode
Dziedziczenie
HotSpotMode

Pola

Inactive 3

Element HotSpot nie ma żadnego zachowania.

Navigate 1

Spowoduje HotSpot to przejście do adresu URL.

NotSet 0

Obiekt HotSpot używa zachowania ustawionego ImageMap przez właściwość kontrolki HotSpotMode . Jeśli kontrolka ImageMap nie definiuje zachowania, HotSpot obiekt przechodzi do adresu URL.

PostBack 2

Element HotSpot generuje powrót do serwera.

Przykłady

W poniższym przykładzie kodu pokazano, jak ustawić ImageMap.HotSpotMode właściwość za HotSpotMode pomocą wartości wyliczenia. Strona zawiera kontrolkę zawierającą ImageMap dwa RectangleHotSpot obiekty. Właściwość jest ustawiona ImageMap.HotSpotMode na HotSpotMode.PostBack, co powoduje, że strona jest publikowana z powrotem na serwerze za każdym razem, gdy użytkownik kliknie jeden z regionów hot spot. Właściwość HotSpotMode nie jest ustawiana na jednym z RectangleHotSpot obiektów, ponieważ pobierają zachowanie z ImageMap.HotSpotMode właściwości . Aby ten przykład działał poprawnie, musisz podać własny obraz dla ImageUrl właściwości i odpowiednio zaktualizować ścieżkę do obrazu, aby aplikacja mogła ją zlokalizować.

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

Uwagi

Wyliczenie HotSpotMode reprezentuje zachowania, które można zastosować do HotSpot obiektu w kontrolce ImageMap . Właściwości ImageMap.HotSpotMode i HotSpot.HotSpotMode używają tych wartości wyliczenia, aby ustawić zachowanie obiektu po kliknięciu HotSpot . Jeśli obie właściwości są ustawione, HotSpot.HotSpotMode właściwość określona dla każdego pojedynczego HotSpot obiektu ma pierwszeństwo przed właściwością ImageMap.HotSpotMode kontrolki.

Jeśli określisz właściwość pojedynczego HotSpot obiektu, HotSpot jego zachowanie zostanie odebrane z właściwości kontrolki zawierającej ImageMap.HotSpotModeImageMap.HotSpotMode.NotSetHotSpot.HotSpotMode W tym scenariuszu ImageMap , jeśli właściwość kontrolki HotSpotMode jest określona NotSet lub żadna wartość, domyślne zachowanie polega na przejściu do adresu URL.

Uwaga

ImageMap Jeśli zachowanie kontrolki nie jest określone przy użyciu ImageMap.HotSpotMode właściwości lub HotSpot.HotSpotMode właściwości w HotSpot obiektach, które zawiera, domyślnie zachowanie to HotSpotMode.Navigate. Ponadto, jeśli HotSpot.HotSpotMode właściwości obiektów HotSpot , które zawiera kontrolka ImageMap , są ustawione na HotSpotMode.NotSet i nie określono żadnej wartości dla ImageMap.HotSpotMode właściwości, domyślne zachowanie to HotSpotMode.Navigate.

Jeśli określisz HotSpotMode.NavigateImageMap.HotSpotMode właściwość lub HotSpot.HotSpotMode właściwość, strona przechodzi do adresu URL po kliknięciu HotSpot . Image.NavigateUrl Użyj właściwości lub HotSpot.NavigateUrl , aby określić adres URL do przejścia.

Jeśli określisz HotSpotMode.PostBackImageMap.HotSpotMode właściwość lub HotSpot.HotSpotMode właściwość, strona generuje postback na serwerze po kliknięciu HotSpot . PostBackValue Użyj właściwości , aby określić nazwę HotSpot obiektu. Ta nazwa zostanie przekazana w danych zdarzenia po wystąpieniu ImageMapEventArgs zdarzenia zwrotnego. Po kliknięciu Click ogłaszania zwrotnego HotSpot zdarzenie jest zgłaszane. Aby programowo kontrolować akcje wykonywane po kliknięciu ogłaszania zwrotnego HotSpot , podaj procedurę obsługi zdarzeń dla Click zdarzenia.

Jeśli określisz HotSpotMode.Inactive właściwość , HotSpot obiekt nie ma żadnego zachowania po kliknięciuHotSpot.HotSpotMode. Tej wartości można użyć do utworzenia nieaktywnego punktu gorącego w większym aktywnym miejscu gorącym. Ta opcja umożliwia tworzenie bardziej złożonych stref typu spot w ramach kontrolki ImageMap .

Aby utworzyć obszar nieaktywny w aktywnym miejscu dostępu, należy określić nieaktywne miejsce aktywne przed aktywnym w kontrolce ImageMap . Na przykład następujące ImageMap elementy definiują aktywny pierścień, określając nieaktywny okrągły punkt dostępu w większym aktywnym okrągłym miejscu gorącym:

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

Dotyczy

Zobacz też