HotSpotMode HotSpotMode HotSpotMode HotSpotMode Enum

定義

HotSpot がクリックされたときの ImageMap コントロールの HotSpot オブジェクトの動作を指定します。Specifies the behaviors of a HotSpot object in an ImageMap control when the HotSpot is clicked.

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

フィールド

Inactive Inactive Inactive Inactive 3

HotSpot に動作はありません。The HotSpot does not have any behavior.

Navigate Navigate Navigate Navigate 1

HotSpot は URL に移動します。The HotSpot navigates to a URL.

NotSet NotSet NotSet NotSet 0

HotSpot は、ImageMap コントロールの HotSpotMode プロパティで設定される動作を使用します。The HotSpot uses the behavior set by the ImageMap control's HotSpotMode property. ImageMap コントロールで動作が定義されていない場合、HotSpot オブジェクトは URL に移動します。If the ImageMap control does not define the behavior, the HotSpot object navigates to a URL.

PostBack PostBack PostBack PostBack 2

HotSpot はサーバーへのポストバックを生成します。The HotSpot generates a postback to the server.

次のコード例は、使用する方法を示します、HotSpotMode列挙の値を設定、ImageMap.HotSpotModeプロパティ。The following code example demonstrates how to use the HotSpotMode enumeration values to set the ImageMap.HotSpotMode property. ページが含まれています、 ImageMap 2 つを格納しているコントロールRectangleHotSpotオブジェクト。The page contains an ImageMap control that contains two RectangleHotSpot objects. ImageMap.HotSpotModeプロパティに設定されてHotSpotMode.PostBack、ホット スポットのリージョンのいずれかをクリックしたページにポストバック、サーバーごとにユーザーを停止します。The ImageMap.HotSpotMode property is set to HotSpotMode.PostBack, which causes the page to post back to the server each time a user clicks one of the hot spot regions. HotSpotModeのいずれかのプロパティが設定されていない、RectangleHotSpotの動作を取得するため、オブジェクト、ImageMap.HotSpotModeプロパティ。The HotSpotMode property is not set on either of the RectangleHotSpot objects because they get their behavior from the ImageMap.HotSpotMode property. 正常に動作するこの例では、独自のイメージを指定する必要があります、ImageUrlプロパティと、アプリケーションが特定できるようににイメージへのパスを適切に更新します。For this example to work correctly, you must supply your own image for the ImageUrl property and update the path to the image appropriately so that the application can locate it.

<%@ 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コントロール。The HotSpotMode enumeration represents the behaviors that you can apply to a HotSpot object within an ImageMap control. ImageMap.HotSpotModeHotSpot.HotSpotModeプロパティの動作を設定するこれらの列挙値を使用して、HotSpotオブジェクトがクリックされたときにします。The ImageMap.HotSpotMode and the HotSpot.HotSpotMode properties use these enumeration values to set the behavior of a HotSpot object when it is clicked. 両方のプロパティが設定されている場合、HotSpot.HotSpotModeごとに指定されたプロパティHotSpotオブジェクトよりも優先、ImageMap.HotSpotModeコントロールのプロパティ。If both properties are set, the HotSpot.HotSpotMode property specified on each individual HotSpot object takes precedence over the ImageMap.HotSpotMode property on the control.

指定した場合HotSpotMode.NotSetHotSpot.HotSpotModeプロパティを個別HotSpotオブジェクト、HotSpot含むからその動作を取得ImageMapコントロールのImageMap.HotSpotModeプロパティ。If you specify HotSpotMode.NotSet for the HotSpot.HotSpotMode property of an individual HotSpot object, the HotSpot gets its behavior from the containing ImageMap control's ImageMap.HotSpotMode property. このシナリオの場合、ImageMapコントロールのHotSpotModeプロパティがNotSetまたは値が指定されていない、既定の動作は、URL に移動するのには。In this scenario, if the ImageMap control's HotSpotMode property is either NotSet or no value is specified, the default behavior is to navigate to a URL.

注意

場合、ImageMapコントロールの動作がいずれかを使用して指定されていない、ImageMap.HotSpotModeプロパティまたはHotSpot.HotSpotModeプロパティをHotSpotオブジェクトの動作は既定でそれに含まれるHotSpotMode.Navigateします。If an ImageMap control's behavior is not specified using either the ImageMap.HotSpotMode property or the HotSpot.HotSpotMode property on the HotSpot objects it contains, by default the behavior is HotSpotMode.Navigate. さらに場合、HotSpot.HotSpotModeプロパティをHotSpotオブジェクトをImageMapコントロールが含まれてに設定されているHotSpotMode.NotSetの値が指定されていないと、ImageMap.HotSpotModeプロパティは、既定の動作ですHotSpotMode.Navigateします。In addition, if the HotSpot.HotSpotMode properties on the HotSpot objects that an ImageMap control contains are set to HotSpotMode.NotSet and no value is specified for the ImageMap.HotSpotMode property, the default behavior is HotSpotMode.Navigate.

指定した場合HotSpotMode.Navigateのいずれか、ImageMap.HotSpotModeプロパティまたはHotSpot.HotSpotModeプロパティ ページを URL に移動する場合と、HotSpotがクリックされました。If you specify HotSpotMode.Navigate for either the ImageMap.HotSpotMode property or the HotSpot.HotSpotMode property, the page navigates to a URL when the HotSpot is clicked. 使用して、Image.NavigateUrlまたはHotSpot.NavigateUrlプロパティに移動する URL を指定します。Use the Image.NavigateUrl or the HotSpot.NavigateUrl property to specify the URL to navigate to.

指定した場合HotSpotMode.PostBackのいずれか、ImageMap.HotSpotModeプロパティまたはHotSpot.HotSpotModeプロパティ ページがサーバーへのポストバックを生成するときに、HotSpotがクリックされました。If you specify HotSpotMode.PostBack for either the ImageMap.HotSpotMode property or the HotSpot.HotSpotMode property, the page generates a postback to the server when the HotSpot is clicked. 使用して、PostBackValueプロパティの名前を指定する、HotSpotオブジェクト。Use the PostBackValue property to specify a name for the HotSpot object. この名前で渡される、ImageMapEventArgsポストバック イベントの発生時にイベント データ。This name will be passed in the ImageMapEventArgs event data when the postback event occurs. ポストバック時にHotSpotがクリックされた、Clickイベントが発生します。When a postback HotSpot is clicked, the Click event is raised. ポストバック時にアクションが実行をプログラムから制御HotSpotがクリックすると、イベント ハンドラーを提供、Clickイベント。To programmatically control the actions performed when a postback HotSpot is clicked, provide an event handler for the Click event.

指定した場合HotSpotMode.InactiveHotSpot.HotSpotModeプロパティ、HotSpotオブジェクトにそれをクリックすると、動作がないです。If you specify HotSpotMode.Inactive for the HotSpot.HotSpotMode property, the HotSpot object does not have any behavior when it is clicked. この値を使用すると、大きい active ホット スポットの中の非アクティブのホット スポットを作成します。You can use this value to create an inactive hot spot within a larger active hot spot. このオプションを指定すると、内でより複雑なホット スポットのゾーンを作成すること、ImageMapコントロール。This option is provided to allow you to create more complex hot spot zones within an ImageMap control.

アクティブなホット スポット内の非アクティブな領域を作成するで作業中の 1 つ前に、アクティブなホット スポットを指定する必要があります、ImageMapコントロール。To create an inactive area within an active hot spot, you must specify the inactive hot spot before the active one in the ImageMap control. たとえば、次ImageMap大きい active 循環ホット スポット内で非アクティブな循環ホット スポットを指定して、アクティブなリングを定義します。For example, the following ImageMap defines an active ring by specifying an inactive circular hot spot within a larger active circular hot spot:

<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>  

適用対象

こちらもご覧ください