HotSpotMode 列舉

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

指定當按一下 HotSpot 時，ImageMap 控制項中 HotSpot 物件的行為。

public enum class HotSpotMode

public enum HotSpotMode

type HotSpotMode =

Public Enum HotSpotMode

繼承: Object

ValueType

Enum
HotSpotMode

欄位

Inactive	3	HotSpot 沒有任何行為。
Navigate	1	HotSpot 巡覽至 URL。
NotSet	0	HotSpot 使用由 ImageMap 控制項的 HotSpotMode 屬性所設定的行為。如果 ImageMap 控制項未定義行為，HotSpot 物件會巡覽至 URL。
PostBack	2	HotSpot 產生回傳給伺服器。

範例

下列程式碼範例示範如何使用 HotSpotMode 列舉值來設定 ImageMap.HotSpotMode 屬性。頁面包含包含兩 RectangleHotSpot 個 ImageMap 物件的控制項。屬性 ImageMap.HotSpotMode 設定為 HotSpotMode.PostBack ，這會導致每次使用者按一下其中一個作用點區域時，將頁面回傳至伺服器。 HotSpotMode屬性不是在任一 RectangleHotSpot 物件上設定，因為它們會從 ImageMap.HotSpotMode 屬性取得其行為。若要讓這個範例正常運作，您必須提供屬性自己的映射 ImageUrl ，並適當地更新映射的路徑，讓應用程式可以找到它。

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

備註

列舉 HotSpotMode 表示您可以套用至 HotSpot 控制項內 ImageMap 物件的行為。 ImageMap.HotSpotMode和屬性會 HotSpot.HotSpotMode 使用這些列舉值，在按一下物件時設定物件的行為 HotSpot 。如果同時設定這兩個屬性， HotSpot.HotSpotMode 則每個個別 HotSpot 物件上指定的屬性會優先于 ImageMap.HotSpotMode 控制項上的屬性。

如果您為 HotSpot.HotSpotMode 個別物件的屬性指定 HotSpotMode.NotSet ，則 HotSpot 會從包含 ImageMap 控制項的 ImageMap.HotSpotMode 屬性取得其 HotSpot 行為。在此案例中，如果 ImageMap 控制項的 HotSpotMode 屬性是 NotSet 或未指定任何值，則預設行為是巡覽至 URL。

注意

ImageMap如果未使用 ImageMap.HotSpotMode 控制項包含之物件的屬性或 HotSpot.HotSpotMode 屬性 HotSpot 來指定控制項的行為，則行為預設為 HotSpotMode.Navigate 。此外，如果 HotSpot.HotSpotMode 控制項包含的物件 ImageMap 屬性 HotSpot 已設定為 HotSpotMode.NotSet ，而且沒有為 ImageMap.HotSpotMode 屬性指定任何值，則預設行為為 HotSpotMode.Navigate 。

如果您指定 HotSpotMode.NavigateImageMap.HotSpotMode 屬性或 HotSpot.HotSpotMode 屬性，則按一下時 HotSpot ，頁面會巡覽至 URL。 Image.NavigateUrl使用或 HotSpot.NavigateUrl 屬性來指定要巡覽的 URL。

如果您指定 HotSpotMode.PostBackImageMap.HotSpotMode 屬性或 HotSpot.HotSpotMode 屬性，則按一下時 HotSpot ，頁面會產生回傳至伺服器。使用 PostBackValue 屬性來指定物件的名稱 HotSpot 。發生回傳事件時，此名稱將會在事件資料中 ImageMapEventArgs 傳遞。按一下回 HotSpot 傳時，就會 Click 引發事件。若要以程式設計方式控制按一下回 HotSpot 傳時所執行的動作，請提供 Click 事件的事件處理常式。

如果您為 HotSpot.HotSpotMode 屬性指定 HotSpotMode.Inactive ， HotSpot 則按一下物件時沒有任何行為。您可以使用此值，在較大的作用中作用中作用點內建立非作用中作用中的作用點。提供此選項可讓您在控制項內 ImageMap 建立更複雜的作用點區域。

若要在作用中點內建立非作用中區域，您必須先指定非作用中的作用中作用中作用點，再于控制項中的作用中 ImageMap 。例如，下列 ImageMap 程式碼會藉由在較大的作用中迴圈作用點內指定非作用中迴圈作用點來定義作用中環形：

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

適用於

HotSpotMode 列舉

定義

欄位

範例

備註

適用於

另請參閱

意見反應

其他資源