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.NotSetHotSpot.HotSpotMode個別HotSpot對象的屬性時，會HotSpot從控件的 HotSpotMode 屬性值ImageMap判斷其行為。

如果您指定 HotSpotMode.NavigateImageMap.HotSpotMode 屬性，當按兩下時 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 屬性

定義

屬性值

例外狀況

範例

備註

適用於

另請參閱

其他資源