ImageMap.HotSpotMode プロパティ

.NET Framework クラス ライブラリ リファレンス

ImageMap.HotSpotMode プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 HotSpotMode As HotSpotMode

Visual Basic (使用法)

Dim instance As ImageMap
Dim value As HotSpotMode

value = instance.HotSpotMode

instance.HotSpotMode = value

C#

public virtual HotSpotMode HotSpotMode { get;
 set; }

C++

public:
virtual property HotSpotMode HotSpotMode {
    HotSpotMode get ();
    void set (HotSpotMode value);
}

J#

/** @property */
public HotSpotMode get_HotSpotMode ()

/** @property */
public void set_HotSpotMode (HotSpotMode value)

JScript

public function get HotSpotMode
 () : HotSpotMode

public function set HotSpotMode
 (value : HotSpotMode)

プロパティ値
HotSpotMode 列挙値の 1 つ。既定値は NotSet です。

例外

例外の種類	条件
ArgumentOutOfRangeException	指定した型が HotSpotMode 列挙値ではありません。

解説

HotSpotMode プロパティを使用して、ImageMap コントロール内にある HotSpot オブジェクトの既定のクリック動作を指定します。このプロパティは、HotSpotMode 列挙値の 1 つを使用して設定します。有効値の一覧を次の表に示します。

項目	説明
Inactive	HotSpot に動作がありません。
NotSet	HotSpot オブジェクトは、ImageMap コントロールの HotSpotMode プロパティで設定される動作を使用します。ImageMap コントロールで動作が定義されていない場合、HotSpot オブジェクトはすべて URL に移動します。
Navigate	HotSpot オブジェクトは URL に移動します。
PostBack	HotSpot オブジェクトはサーバーへのポストバックを生成します。

HotSpot オブジェクトの動作は、ImageMap コントロールの ImageMap.HotSpotMode プロパティか、個々の HotSpot オブジェクトの HotSpot.HotSpotMode プロパティを使用して指定します。両方のプロパティが設定された場合、ImageMap コントロールの ImageMap.HotSpotMode プロパティよりも、各 HotSpot オブジェクトに指定された HotSpot.HotSpotMode プロパティが優先されます。

ImageMap コントロールの HotSpotMode プロパティを設定する場合は、HotSpotMode.NotSet 値と HotSpotMode.Navigate 値は、どちらも URL に移動する同じ動作となります。個々の HotSpot オブジェクトの HotSpot.HotSpotMode プロパティに HotSpotMode.NotSet を指定した場合、その HotSpot は、ImageMap コントロールの HotSpotMode プロパティの値から動作を決定します。

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

ImageMap.HotSpotMode プロパティに HotSpotMode.PostBack を指定した場合、HotSpot がクリックされたときにページはサーバーへのポストバックを生成します。PostBackValue プロパティを使用して、ホット スポット領域の名前を指定します。この名前は、ポストバック イベントが発生したときに、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>

ImageMap コントロールのすべての HotSpot オブジェクトが同じ動作となるようにするには、ImageMap コントロールの HotSpotMode プロパティを使用して動作を指定します。次に、個々の HotSpot オブジェクトの HotSpotMode プロパティに HotSpotMode.NotSet を設定するか、HotSpot.HotSpotMode プロパティに値を指定しないようにします。

ImageMap コントロールの各 HotSpot オブジェクトに異なる動作を指定するには、個々の HotSpot オブジェクトの HotSpot.HotSpotMode プロパティに HotSpotMode.Navigate、HotSpotMode.PostBack、または HotSpotMode.Inactive を設定します。

メモ
ImageMap コントロールの ImageMap.HotSpotMode プロパティ、またはそれに含まれる任意の HotSpot オブジェクトの HotSpot.HotSpotMode プロパティに HotSpotMode.NotSet を設定するか、または値を設定しない場合、既定の動作は HotSpotMode.Navigate となります。

Topic	Location
方法 : Web ページに ImageMap Web サーバー コントロールを追加する (Visual Studio)	Visual Studio での ASP .NET Web アプリケーションの作成

使用例

2 つの RectangleHotSpot オブジェクトを含む ImageMap コントロールを、宣言によって作成する方法を次のコード例に示します。ImageMap.HotSpotMode プロパティは HotSpotMode.PostBack に設定されます。この場合、ユーザーがいずれかのホット スポット領域をクリックするたびに、ページがサーバーにポストバックされます。RectangleHotSpot オブジェクトは ImageMap.HotSpotMode プロパティから動作を取得するため、それぞれのオブジェクトには HotSpotMode プロパティを設定しません。この例を正常に動作させるには、ImageUrl プロパティにユーザー独自のイメージを提供し、アプリケーションがそのイメージを見つけられるように、イメージへのパスを適切に更新する必要があります。

Visual Basic

<%@ page language="VB" %>

<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>
<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="Vote 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>

C#

<%@ page language="C#" %>

<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>
<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="Vote 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>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ImageMap クラス
ImageMap メンバ
System.Web.UI.WebControls 名前空間
HotSpotMode 列挙体
HotSpot.HotSpotMode プロパティ
HotSpot.PostBackValue プロパティ
HotSpot.NavigateUrl プロパティ
Click
その他の技術情報
ImageMap Web サーバー コントロール