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 控件上的属性。

如果 HotSpotMode.NotSet 指定 HotSpot.HotSpotMode 单个 HotSpot 对象的属性，则 HotSpot 从包含 ImageMap 控件的 ImageMap.HotSpotMode 属性获取其行为。在此方案中，如果 ImageMap 控件的 HotSpotMode 属性为 NotSet 或未指定值，则默认行为是导航到 URL。

注意

ImageMap如果未使用 ImageMap.HotSpotMode 控件包含的对象上的 HotSpot 属性或 HotSpot.HotSpotMode 属性指定控件的行为，则默认情况下该行为为 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。

如果为 ImageMap.HotSpotMode 属性或 HotSpot.HotSpotMode 属性指定HotSpotMode.PostBack，则页面会在单击时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 枚举

定义

字段

示例

注解

适用于

另请参阅

其他资源