PolygonHotSpot 類別

參考

定義

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

組件:: System.Web.dll

重要

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

定義 ImageMap 控制項中的多邊形作用點區域。此類別無法獲得繼承。

public ref class PolygonHotSpot sealed : System::Web::UI::WebControls::HotSpot

public sealed class PolygonHotSpot : System.Web.UI.WebControls.HotSpot

type PolygonHotSpot = class
    inherit HotSpot

Public NotInheritable Class PolygonHotSpot
Inherits HotSpot

繼承: Object

HotSpot
PolygonHotSpot

範例

下列程式碼範例示範如何建立包含三 PolygonHotSpot 個 ImageMap 物件的控制項。每個 PolygonHotSpot 物件都代表地圖上的地理區域。當使用者按一下 PolygonHotSpot 物件時，它會回傳至伺服器，且作用點的類型和名稱會顯示在標籤中。

<%@ 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 RegionMap_Clicked (object sender, ImageMapEventArgs e)
  {
    string hotSpotType;

    // When a user clicks a hot spot, display
    // the hot spot's type and name.
    switch (e.PostBackValue)
    {
      case "Western":
        hotSpotType = Regions.HotSpots[0].ToString();
        Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue;
        break;
        
      case "Northern":
        hotSpotType = Regions.HotSpots[1].ToString();
        Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue;
        break;

      case "Southern":
        hotSpotType = Regions.HotSpots[2].ToString();
        Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue;
        break;

      default:
        Message1.Text = "You did not click a valid hot spot region.";
        break;
    }
  }  
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>PolygonHotSpot Class Example</title>
</head>
  <body>
    <form id="Form1" runat="server">
    
      <h3>PolygonHotSpot Example</h3>
      
      <!-- Change or remove the width and height attributes as
           appropriate for your image. -->
      <asp:imagemap id="Regions"           
        imageurl="Images/RegionMap.jpg"
        alternatetext="Sales regions" 
        hotspotmode="PostBack"
        width="400"
        height="400"
        onclick="RegionMap_Clicked"   
        runat="Server">            
          
        <asp:PolygonHotSpot 
          coordinates="0,0,176,0,125,182,227,400,0,400"         
          postbackvalue="Western"
          alternatetext="Western Region">
        </asp:PolygonHotSpot>
          
        <asp:PolygonHotSpot 
          coordinates="177,0,400,0,400,223,335,154,127,180"         
          postbackvalue="Northern"
          alternatetext="Northern Region">
        </asp:PolygonHotSpot>
        
        <asp:PolygonHotSpot 
          coordinates="128,185,335,157,400,224,400,400,228,400"         
          postbackvalue="Southern"
          alternatetext="Southern Region">
        </asp:PolygonHotSpot>
      
      </asp:imagemap>
            
      <br /><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 RegionMap_Clicked(ByVal sender As Object, ByVal e As ImageMapEventArgs)
    Dim hotSpotType As String
        
    ' When a user clicks a hot spot, display
    ' the hot spot's type and name.
    Select Case (e.PostBackValue)
      
      Case ("Western")
        hotSpotType = Regions.HotSpots(0).ToString()
        Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue
      
      Case ("Northern")
        hotSpotType = Regions.HotSpots(1).ToString()
        Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue
      
      Case ("Southern")
        hotSpotType = Regions.HotSpots(2).ToString()
        Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue
      
      Case Else
        Message1.Text = "You did not click a valid hot spot region."
    
    End Select

  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>PolygonHotSpot Class Example</title>
</head>
  <body>
    <form id="Form1" runat="server">
    
      <h3>PolygonHotSpot Example</h3>
      
      <!-- Change or remove the width and height attributes as
           appropriate for your image. -->
      <asp:imagemap id="Regions"           
        imageurl="Images/RegionMap.jpg"
        alternatetext="Sales regions" 
        hotspotmode="PostBack"
        width="400"
        height="400"
        onclick="RegionMap_Clicked"   
        runat="Server">            
          
        <asp:PolygonHotSpot 
          coordinates="0,0,176,0,125,182,227,400,0,400"         
          postbackvalue="Western"
          alternatetext="Western Region">
        </asp:PolygonHotSpot>
          
        <asp:PolygonHotSpot 
          coordinates="177,0,400,0,400,223,335,154,127,180"         
          postbackvalue="Northern"
          alternatetext="Northern Region">
        </asp:PolygonHotSpot>
        
        <asp:PolygonHotSpot 
          coordinates="128,185,335,157,400,224,400,400,228,400"         
          postbackvalue="Southern"
          alternatetext="Southern Region">
        </asp:PolygonHotSpot>
      
      </asp:imagemap>
            
      <br /><br />
          
      <asp:label id="Message1"
        runat="Server">
      </asp:label>                 
                 
    </form>      
  </body>
</html>

備註

這個類別會在控制項中 ImageMap 定義多邊形作用點區域。適用于 PolygonHotSpot 在控制項中 ImageMap 定義不規則形狀的作用點區域。例如，您可以使用它來定義地理地圖內的個別區域。

若要定義的區域 PolygonHotSpot ，請將 Coordinates 屬性設定為字串，以指定物件每個頂點的 PolygonHotSpot 座標。多邊形頂點是兩個多邊形邊緣符合的點。

PolygonHotSpot按一下物件時，頁面會巡覽至 URL、產生回傳至伺服器，或不執行任何動作。屬性 HotSpotMode 會指定此行為。若要流覽至 URL，請將 HotSpotMode 屬性設定為 HotSpotMode.Navigate ，並使用 NavigateUrl 屬性來指定要巡覽的 URL。若要回傳至伺服器，請將 HotSpotMode 屬性 HotSpotMode.PostBack 設定為，並使用 PostBackValue 屬性來指定物件的名稱 PolygonHotSpot 。按一下時 PolygonHotSpot ， ImageMapEventArgs 此名稱會在事件資料中傳遞。如果您想要 PolygonHotSpot 物件沒有行為，請將 HotSpotMode 屬性設定為 HotSpotMode.Inactive 。

建構函式

PolygonHotSpot()

初始化 PolygonHotSpot 類別的新執行個體。

屬性

AccessKey	取得或設定可讓您快速巡覽至 HotSpot 區域的便捷鍵 (Access Key)。 (繼承來源 HotSpot)
AlternateText	取得或設定當影像無法使用或呈現至不支援影像的瀏覽器時，要針對 HotSpot 控制項中的 ImageMap 物件顯示的替代文字。 (繼承來源 HotSpot)
Coordinates	字串，代表 PolygonHotSpot 物件端點的座標。
HotSpotMode	取得或設定按一下 HotSpot 時，ImageMap 控制項中 HotSpot 物件的行為。 (繼承來源 HotSpot)
IsTrackingViewState	取得值，指出 HotSpot 物件是否正在追蹤它的檢視狀態變更。 (繼承來源 HotSpot)
MarkupName	在衍生類別中覆寫時，取得 HotSpot 物件形狀的字串表示。 (繼承來源 HotSpot)
NavigateUrl	取得或設定在按一下 HotSpot 物件時所要巡覽的 URL。 (繼承來源 HotSpot)
PostBackValue	取得或設定按一下 HotSpot 後，要傳入事件資料的 HotSpot 物件名稱。 (繼承來源 HotSpot)
TabIndex	取得或設定 HotSpot 區域的定位索引。 (繼承來源 HotSpot)
Target	取得或設定按一下巡覽至 URL 的 HotSpot 物件時，要顯示所連結之 Web 網頁內容的目標視窗或框架。 (繼承來源 HotSpot)
ViewState	取得狀態資訊的字典，允許您在相同頁面的多個要求之間，儲存和還原 HotSpot 物件的檢視狀態。 (繼承來源 HotSpot)

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetCoordinates()	傳回字串，代表 PolygonHotSpot 物件端點的座標。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
LoadViewState(Object)	將 HotSpot 物件先前儲存的檢視狀態還原至物件。 (繼承來源 HotSpot)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
SaveViewState()	儲存自頁面回傳至伺服器以來 HotSpot 物件檢視狀態的變更。 (繼承來源 HotSpot)
ToString()	傳回 String 物件之這個執行個體的 HotSpot 表示。 (繼承來源 HotSpot)
TrackViewState()	讓 HotSpot 物件追蹤其檢視狀態的變更，以便將這些變更儲存在物件的 StateBag 物件中。這個物件可透過 ViewState 屬性存取。 (繼承來源 HotSpot)

明確介面實作

IStateManager.IsTrackingViewState	取得值，指出 HotSpot 物件是否正在追蹤它的檢視狀態變更。 (繼承來源 HotSpot)
IStateManager.LoadViewState(Object)	將 HotSpot 物件先前儲存的檢視狀態還原至物件。 (繼承來源 HotSpot)
IStateManager.SaveViewState()	儲存自上次頁面回傳至伺服器以來 HotSpot 物件檢視狀態的變更。 (繼承來源 HotSpot)
IStateManager.TrackViewState()	指示 HotSpot 區域追蹤其檢視狀態的變更。 (繼承來源 HotSpot)

適用於

PolygonHotSpot 類別

定義

範例

備註

建構函式

屬性

方法

明確介面實作

適用於

另請參閱

其他資源