ImageMap.HotSpotMode Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia domyślne zachowanie dla HotSpot obiektów ImageMap kontrolki po kliknięciu HotSpot obiektów.

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

Wartość właściwości

HotSpotMode

Jedna z HotSpotMode wartości wyliczenia. Wartość domyślna to NotSet.

Wyjątki

ArgumentOutOfRangeException

Określony typ nie jest jedną z HotSpotMode wartości wyliczenia.

Przykłady

W poniższym przykładzie kodu pokazano, jak deklaratywnie utworzyć 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 każdym obiekcie RectangleHotSpot , 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

Użyj właściwości , HotSpotMode aby określić domyślne zachowanie HotSpot kliknięć obiektów w kontrolce ImageMap . Ta właściwość jest ustawiana przy użyciu jednej z HotSpotMode wartości wyliczenia. W poniższej tabeli wymieniono możliwe wartości.

Element	Opis
`Inactive`	Obiekt HotSpot nie ma żadnego zachowania.
`NotSet`	Obiekt HotSpot używa zachowania ustawionego ImageMap przez właściwość kontrolki HotSpotMode . Jeśli kontrolka ImageMap nie definiuje zachowania, HotSpot wszystkie obiekty przechodzą do adresu URL.
`Navigate`	Obiekty HotSpot przechodzą do adresu URL.
`PostBack`	Obiekty HotSpot generują powrót do serwera.

Zachowanie obiektu można określić HotSpot przy użyciu ImageMap.HotSpotMode właściwości ImageMap kontrolki lub HotSpot.HotSpotMode właściwości każdego obiektu 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 ImageMap .

Po ustawieniu HotSpotMode właściwości kontrolki ImageMap należy pamiętać, że HotSpotMode.NotSet wartości i HotSpotMode.Navigate mają takie samo zachowanie: obaj przechodzą do adresu URL. Po określeniu HotSpotMode.NotSetHotSpot.HotSpotMode właściwości pojedynczego HotSpot obiektu HotSpot określa jego zachowanie z wartości HotSpotMode właściwości kontrolki ImageMap .

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

Jeśli określisz HotSpotMode.PostBack właściwość ImageMap.HotSpotMode , strona generuje powrót do serwera po kliknięciu HotSpot . Użyj właściwości , PostBackValue aby określić nazwę regionu hot spot. 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 miejscem gorącym 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>

Aby spowodować, że wszystkie HotSpot obiekty w kontrolce ImageMap mają takie samo zachowanie, użyj HotSpotMode właściwości kontrolki ImageMap , aby określić zachowanie. Następnie ustaw HotSpotMode właściwość dla każdego obiektu HotSpot na wartość lub nie należy określać HotSpotMode.NotSet wartości dla HotSpot.HotSpotMode właściwości.

Aby określić różne zachowania dla HotSpot obiektów w kontrolceImageMap, ustaw HotSpot.HotSpotMode właściwość dla każdego obiektu HotSpotHotSpotMode.Navigatena wartość , lub HotSpotMode.PostBackHotSpotMode.Inactive.

Uwaga

ImageMap Jeśli właściwość kontrolki ImageMap.HotSpotMode lub HotSpot.HotSpotMode właściwość w dowolnym z HotSpot obiektów, które zawiera, jest ustawiona na HotSpotMode.NotSet wartość lub nie jest ustawiona na wartość, domyślnie zachowanie to HotSpotMode.Navigate.

Dotyczy