PolygonHotSpot クラス

定義

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
継承
PolygonHotSpot

次のコード例では、3 つの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 設定します。 ポリゴン頂点とは、2 つのポリゴン エッジが交わる点です。

オブジェクトが PolygonHotSpot クリックされると、ページは URL に移動し、サーバーにポストを生成するか、何も実行しません。 プロパティは HotSpotMode 、この動作を指定します。 URL に移動するには、 プロパティを HotSpotModeHotSpotMode.Navigate設定し、 プロパティを NavigateUrl 使用して移動先の URL を指定します。 サーバーにポストバックするには、 プロパティを HotSpotModeHotSpotMode.PostBack設定し、 プロパティを PostBackValue 使用してオブジェクトの名前を PolygonHotSpot 指定します。 この名前は、 がクリックされたときにPolygonHotSpotイベント データにImageMapEventArgs渡されます。 オブジェクトに PolygonHotSpot 動作を設定しない場合は、 プロパティを HotSpotModeHotSpotMode.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 オブジェクトがクリックされたときに、リンク先 Web ページの内容を表示するウィンドウまたはフレームを取得または設定します。

(継承元 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)

適用対象

こちらもご覧ください