HotSpotMode 列挙型

定義

HotSpot がクリックされたときの ImageMap コントロールの HotSpot オブジェクトの動作を指定します。

public enum class HotSpotMode
public enum HotSpotMode
type HotSpotMode = 
Public Enum HotSpotMode
継承
HotSpotMode

フィールド

Inactive 3

HotSpot に動作はありません。

Navigate 1

HotSpot は URL に移動します。

NotSet 0

HotSpot は、ImageMap コントロールの HotSpotMode プロパティで設定される動作を使用します。 ImageMap コントロールで動作が定義されていない場合、HotSpot オブジェクトは URL に移動します。

PostBack 2

HotSpot はサーバーへのポストバックを生成します。

次のコード例では、列挙値を使用して プロパティを HotSpotMode 設定する方法を ImageMap.HotSpotMode 示します。 ページには、2 つのRectangleHotSpotオブジェクトをImageMap含むコントロールが含まれています。 ImageMap.HotSpotModeプロパティは にHotSpotMode.PostBack設定されています。これにより、ユーザーがいずれかのホット スポット領域をクリックするたびに、ページがサーバーにポストバックされます。 プロパティはHotSpotMode、 プロパティからImageMap.HotSpotMode動作を取得するため、RectangleHotSpotどちらのオブジェクトにも設定されません。 この例を正しく機能させるには、 プロパティに独自のイメージを 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.HotSpotModeHotSpot.HotSpotMode これらの列挙値を使用して、クリックされたオブジェクトの動作を HotSpot 設定します。 両方のプロパティが設定されている場合は、 HotSpot.HotSpotMode 各オブジェクト HotSpot で指定されたプロパティがコントロールの ImageMap.HotSpotMode プロパティよりも優先されます。

個々HotSpotのオブジェクトの プロパティに HotSpot.HotSpotMode を指定HotSpotMode.NotSetした場合、 HotSpot は、含まれているコントロールの ImageMap.HotSpotMode プロパティから動作をImageMap取得します。 このシナリオでは、コントロールの ImageMapHotSpotMode プロパティが 値を指定しないか、または指定 NotSet されていない場合、既定の動作は URL に移動することです。

Note

コントロールのImageMap動作が、そのコントロールに含まれるオブジェクトの プロパティまたは HotSpot.HotSpotMode プロパティHotSpotImageMap.HotSpotMode使用して指定されていない場合、既定では動作は ですHotSpotMode.Navigate。 さらに、コントロールにHotSpot.HotSpotMode含まれるオブジェクトImageMapHotSpotプロパティが に設定されていて、 プロパティにHotSpotMode.NotSet値が指定ImageMap.HotSpotModeされていない場合、既定の動作は になりますHotSpotMode.Navigate

プロパティまたは プロパティに ImageMap.HotSpotMode を指定HotSpotMode.NavigateしたHotSpot.HotSpotMode場合、 がクリックされるとHotSpot、ページは URL に移動します。 Image.NavigateUrlまたは プロパティをHotSpot.NavigateUrl使用して、移動先の URL を指定します。

プロパティまたは HotSpot.HotSpotMode プロパティに ImageMap.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>  

適用対象

こちらもご覧ください