ImageMap.HotSpotMode 屬性

參考

定義

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

組件:: System.Web.dll

重要

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

取得或設定按一下 HotSpot 物件時，ImageMap 控制項之 HotSpot 物件的預設行為。

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

屬性值

HotSpotMode

其中一個 HotSpotMode 列舉值。預設為 NotSet。

例外狀況

ArgumentOutOfRangeException

指定的型別不是其中一個 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使用屬性可指定控制項內 ImageMap 物件的預設按一下行為 HotSpot 。此屬性是使用其中 HotSpotMode 一個列舉值來設定。下表列出可能的值。

項目	描述
`Inactive`	物件 HotSpot 沒有任何行為。
`NotSet`	物件 HotSpot 會使用控制項的 HotSpotMode 屬性所設定 ImageMap 的行為。 ImageMap如果控制項未定義行為，則 HotSpot 物件全都會流覽至 URL。
`Navigate`	物件 HotSpot 會流覽至 URL。
`PostBack`	物件 HotSpot 會產生回傳至伺服器。

您可以使用控制項的屬性或 HotSpot.HotSpotMode 每個個別 HotSpot 物件的屬性來指定 HotSpot 物件的行為 ImageMap.HotSpotMode 。 ImageMap 如果同時設定這兩個屬性， HotSpot.HotSpotMode 則每個個別 HotSpot 物件上指定的屬性會優先于 ImageMap.HotSpotMode 控制項上的 ImageMap 屬性。

當您設定 HotSpotMode 控制項的 ImageMap 屬性時，請注意 HotSpotMode.NotSet 和 HotSpotMode.Navigate 值的行為相同：兩者都會流覽至 URL。當您 HotSpotMode.NotSet 指定 HotSpot.HotSpotMode 個別 HotSpot 物件的屬性時，會 HotSpot 從 HotSpotMode 控制項的屬性值 ImageMap 判斷其行為。

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

如果您指定 HotSpotMode.PostBackImageMap.HotSpotMode 屬性，頁面會在按一下時 HotSpot 產生回傳至伺服器。 PostBackValue使用屬性來指定作用點區域的名稱。發生回傳事件時， 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>

若要讓控制項中的所有 HotSpot ImageMap 物件具有相同的行為，請使用 HotSpotMode 控制項上的 ImageMap 屬性來指定行為。然後，將每個個別 HotSpot 物件上的屬性設定 HotSpotMode 為 HotSpotMode.NotSet 或未指定屬性的值 HotSpot.HotSpotMode 。

若要為 HotSpot 控制項中的 ImageMap 物件指定不同的行為，請將 HotSpot.HotSpotMode 每個個別 HotSpot 物件的屬性設定為 HotSpotMode.Navigate 、 HotSpotMode.PostBack 或 HotSpotMode.Inactive 。

注意

ImageMap如果控制項 ImageMap.HotSpotMode 的屬性或 HotSpot.HotSpotMode 它包含之任何 HotSpot 物件的屬性設定為或未設定 HotSpotMode.NotSet 為值，則行為預設為 HotSpotMode.Navigate 。

適用於

ImageMap.HotSpotMode 屬性

定義

屬性值

例外狀況

範例

備註

適用於

另請參閱

意見反應

其他資源