ImageMapEventArgs クラス
アセンブリ: System.Web (system.web.dll 内)
構文解説Click イベントは、ImageMap コントロールの HotSpot オブジェクトがクリックされたときに発生します。HotSpot オブジェクトが Click イベントを発生できるようにするには、事前に ImageMap.HotSpotMode プロパティ、または HotSpot.HotSpotMode プロパティに HotSpotMode.PostBack を設定しておく必要があります。ポストバックの HotSpot がクリックされたときに実行されるアクションをプログラムによって制御するには、Click イベントのイベント ハンドラを実装します。
PostBackValue プロパティは、HotSpot オブジェクトがクリックされたときに、その動作に関連する文字列を格納します。この文字列は、HotSpot がクリックされたときに、ImageMapEventArgs イベント データに渡されます。
使用例Click イベントのイベント ハンドラを作成する方法を次のコード例に示します。ImageMap コントロールには、2 つの RectangleHotSpot オブジェクトが含まれます。ImageMap.HotSpotMode プロパティは HotSpotMode.PostBack に設定されます。この場合、ユーザーがいずれかの RectangleHotSpot をクリックするたびに、ページがサーバーにポストバックされます。Click イベントは、VoteMap_Clicked イベント ハンドラで処理されます。VoteMap_Clicked は、ImageMapEventArgs データに送られた PostBackValue プロパティをチェックし、どの RectangleHotSpot オブジェクトがイベントに関連付けられているか確認します。この例を正常に動作させるには、ImageUrl プロパティにユーザー独自のイメージを提供し、アプリケーションがそのイメージを見つけられるように、イメージへのパスを適切に更新する必要があります。
<%@ Page Language="VB" %> <script runat="server"> Sub VoteMap_Clicked(ByVal sender As Object, ByVal e As ImageMapEventArgs) Dim coordinates As String Dim hotSpotType As String Dim yescount As Integer Dim nocount As Integer If (ViewState("yescount") IsNot Nothing) Then yescount = Convert.ToInt32(ViewState("yescount")) Else yescount = 0 End If If (ViewState("nocount") IsNot Nothing) Then nocount = Convert.ToInt32(ViewState("nocount")) Else nocount = 0 End If ' When a user clicks the "Yes" hot spot, ' display the hot spot's name and coordinates. If (e.PostBackValue.Contains("Yes")) Then yescount += 1 coordinates = Vote.HotSpots(0).GetCoordinates() hotSpotType = Vote.HotSpots(0).ToString() Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue & ".<br>" & _ "The coordinates are " & coordinates & ".<br>" & _ "The current vote count is " & yescount.ToString() & _ " yes votes and " & nocount.ToString() & " no votes." ' When a user clicks the "No" hot spot, ' display the hot spot's name and coordinates. ElseIf (e.PostBackValue.Contains("No")) Then nocount += 1 coordinates = Vote.HotSpots.Item(1).GetCoordinates() hotSpotType = Vote.HotSpots.Item(1).ToString() Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue & ".<br>" & _ "The coordinates are " & coordinates & ".<br>" & _ "The current vote count is " & yescount.ToString() & _ " yes votes and " & nocount.ToString() & " no votes." Else Message1.Text = "You did not click a valid hot spot region." End If ViewState("yescount") = yescount ViewState("nocount") = nocount End Sub </script> <html> <head id="Head1" runat="server"> <title>ImageMap Class Post Back Example</title> </head> <body> <form id="Form1" runat="server"> <h3>ImageMap Class Post Back Example</h3> <asp:imagemap id="Vote" imageurl="Images/VoteImage.jpg" width="400" height="200" alternatetext="Vote Yes or No" hotspotmode="PostBack" onclick="VoteMap_Clicked" runat="Server"> <asp:RectangleHotSpot top="0" left="0" bottom="200" right="200" postbackvalue="Yes" alternatetext="Vote yes"> </asp:RectangleHotSpot> <asp:RectangleHotSpot top="0" left="201" bottom="200" right="400" postbackvalue="No" alternatetext="Vote no"> </asp:RectangleHotSpot> </asp:imagemap> <br /><br /> <asp:label id="Message1" runat="Server"> </asp:label> </form> </body> </html>
<%@ page language="C#" %> <script runat="server"> void VoteMap_Clicked (Object sender, ImageMapEventArgs e) { string coordinates; string hotSpotType; int yescount = ((ViewState["yescount"] != null)? (int)ViewState["yescount"] : 0); int nocount = ((ViewState["nocount"] != null)? (int)ViewState["nocount"] : 0); // When a user clicks the "Yes" hot spot, // display the hot spot's name and coordinates. if (e.PostBackValue.Contains("Yes")) { yescount += 1; coordinates = Vote.HotSpots[0].GetCoordinates(); hotSpotType = Vote.HotSpots[0].ToString (); Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue + ".<br>" + "The coordinates are " + coordinates + ".<br>" + "The current vote count is " + yescount.ToString() + " yes votes and " + nocount.ToString() + " no votes."; } // When a user clicks the "No" hot spot, // display the hot spot's name and coordinates. else if (e.PostBackValue.Contains("No")) { nocount += 1; coordinates = Vote.HotSpots[1].GetCoordinates(); hotSpotType = Vote.HotSpots[1].ToString (); Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue + ".<br>" + "The coordinates are " + coordinates + ".<br>" + "The current vote count is " + yescount.ToString() + " yes votes and " + nocount.ToString() + " no votes."; } else { Message1.Text = "You did not click a valid hot spot region."; } ViewState["yescount"] = yescount; ViewState["nocount"] = nocount; } </script> <html> <head id="Head1" runat="server"> <title>ImageMap Class Post Back Example</title> </head> <body> <form id="Form1" runat="server"> <h3>ImageMap Class Post Back Example</h3> <asp:imagemap id="Vote" imageurl="Images/VoteImage.jpg" width="400" height="200" alternatetext="Vote Yes or No" hotspotmode="PostBack" onclick="VoteMap_Clicked" runat="Server"> <asp:RectangleHotSpot top="0" left="0" bottom="200" right="200" postbackvalue="Yes" alternatetext="Vote yes"> </asp:RectangleHotSpot> <asp:RectangleHotSpot top="0" left="201" bottom="200" right="400" postbackvalue="No" alternatetext="Vote no"> </asp:RectangleHotSpot> </asp:imagemap> <br /><br /> <asp:label id="Message1" runat="Server"> </asp:label> </form> </body> </html>
継承階層System.EventArgs
System.Web.UI.WebControls.ImageMapEventArgs
スレッド セーフプラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照ImageMapEventArgs コンストラクタ
アセンブリ: System.Web (system.web.dll 内)
構文解説このコンストラクタを使用して、ImageMapEventArgs クラスの新しいインスタンスを初期化します。
ImageMapEventArgs クラスのインスタンスの初期プロパティ値を次の表に示します。
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照ImageMapEventArgs プロパティ
.gif)
ImageMapEventArgs メソッド
パブリック メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
.gif) | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
| | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
.gif) | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |
参照ImageMapEventArgs メンバ
ImageMap コントロールの Click イベントのデータを提供します。
ImageMapEventArgs データ型で公開されるメンバを以下の表に示します。
パブリック コンストラクタパブリック プロパティパブリック メソッド| 名前 | 説明 | |
|---|---|---|
| | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
| | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
| | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
| | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
| | ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |
プロテクト メソッド| 名前 | 説明 | |
|---|---|---|
| | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
| | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |
参照- ImageMapEventArgsのページへのリンク
