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 区域的访问键。 (继承自 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 对象时在其中显示链接到的网页内容。 (继承自 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 类

定义

示例

注解

构造函数

属性

方法

显式接口实现

适用于

另请参阅

其他资源