Udostępnij za pośrednictwem


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

Używa HotSpot 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ść ImageMap.HotSpotMode jest ustawiona na HotSpotMode.PostBackwartość , co powoduje, że strona będzie publikować z powrotem na serwerze za każdym razem, gdy użytkownik kliknie jeden z regionów gorącego miejsca. Właściwość HotSpotMode nie jest ustawiana na jednym z RectangleHotSpot obiektów, ponieważ pobierają swoje zachowanie z ImageMap.HotSpotMode właściwości. Aby ten przykład działał poprawnie, należy 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, właściwość określona HotSpot.HotSpotMode dla każdego pojedynczego HotSpot obiektu ma pierwszeństwo przed ImageMap.HotSpotMode właściwością kontrolki.

Jeśli określisz HotSpotMode.NotSetHotSpot.HotSpotMode właściwość pojedynczego HotSpot obiektu, HotSpot jego zachowanie zostanie wyświetlone z właściwości zawierającej ImageMap kontrolkę ImageMap.HotSpotMode . W tym scenariuszu, jeśli ImageMap właściwość kontrolki HotSpotMode jest albo NotSet nie jest określona, domyślne zachowanie polega na przejściu do adresu URL.

Uwaga

ImageMap Jeśli zachowanie kontrolki nie zostanie określone przy użyciu ImageMap.HotSpotMode właściwości lub HotSpot.HotSpotMode właściwości w obiektach, które HotSpot zawiera, domyślnie zachowanie to HotSpotMode.Navigate. Ponadto jeśli HotSpot.HotSpotMode właściwości obiektów HotSpot , które ImageMap zawiera kontrolka, są ustawione na HotSpotMode.NotSet wartość 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.Navigate właściwość ImageMap.HotSpotMode lub HotSpot.HotSpotMode właściwość, strona przechodzi do adresu URL po kliknięciu HotSpot . Image.NavigateUrl Użyj właściwości lubHotSpot.NavigateUrl, aby określić adres URL do przejścia.

Jeśli określisz HotSpotMode.PostBack właściwość ImageMap.HotSpotMode lub HotSpot.HotSpotMode właściwość, strona generuje powrót do serwera po kliknięciu HotSpot . Użyj właściwości , PostBackValue aby określić nazwę HotSpot obiektu. Ta nazwa zostanie przekazana w danych zdarzenia po wystąpieniu ImageMapEventArgs zdarzenia zwrotnego. Po kliknięciu po powrocie zwrotne HotSpot zdarzenie zostanie podniesione Click . Aby programowo kontrolować akcje wykonywane po kliknięciu postbacku HotSpot , podaj procedurę obsługi zdarzeń Click dla 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 miejsca gorącego w większym aktywnym miejscu gorącym. Ta opcja umożliwia tworzenie bardziej złożonych stref punktów gorących w ramach kontrolki ImageMap .

Aby utworzyć obszar nieaktywny w aktywnym miejscu gorącym, należy określić nieaktywne miejsce gorące przed aktywnym w kontrolce ImageMap . Na przykład następujące ImageMap definicje aktywnego pierścienia przez określenie nieaktywnego cyklicznego miejsca gorącego w większym aktywnym cyklicznym 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ż