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。

如果您為 ImageMap.HotSpotMode 屬性或 HotSpot.HotSpotMode 屬性指定 HotSpotMode.Navigate ，則按下時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 列舉

定義

欄位

範例

備註

適用於

另請參閱

其他資源