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 obiektów HotSpot kontrolki ImageMap 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

HotSpotMode Jedna z 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ść 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 każdym z RectangleHotSpot obiektów, ponieważ ich zachowanie jest uzyskiwane 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

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 kontrolki ImageMap lub HotSpot.HotSpotMode właściwości każdego pojedynczego HotSpot obiektu. 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 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 na podstawie wartości HotSpotMode właściwości kontrolki ImageMap .

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

Jeśli określisz HotSpotMode.PostBackImageMap.HotSpotMode dla właściwości, strona wygeneruje postback na serwerze po kliknięciu HotSpot . PostBackValue Użyj właściwości , aby określić nazwę regionu hot spot. 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ć nieaktywny obszar w aktywnym miejscu dostępu, należy określić nieaktywne miejsce dostępu przed aktywnym miejscem dostępu 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>

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

Aby określić różne zachowania obiektów HotSpot w kontrolce ImageMap , ustaw HotSpot.HotSpotMode właściwość dla każdego pojedynczego HotSpot obiektu na HotSpotMode.Navigatewartość , HotSpotMode.PostBacklub HotSpotMode.Inactive.

Uwaga

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

Dotyczy

Udostępnij za pośrednictwem