ImageMap.HotSpotMode プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文Dim instance As ImageMap Dim value As HotSpotMode value = instance.HotSpotMode instance.HotSpotMode = value
public: virtual property HotSpotMode HotSpotMode { HotSpotMode get (); void set (HotSpotMode value); }
/** @property */ public HotSpotMode get_HotSpotMode () /** @property */ public void set_HotSpotMode (HotSpotMode value)
public function get HotSpotMode () : HotSpotMode public function set HotSpotMode (value : HotSpotMode)
HotSpotMode 列挙値の 1 つ。既定値は NotSet です。
例外解説HotSpotMode プロパティを使用して、ImageMap コントロール内にある HotSpot オブジェクトの既定のクリック動作を指定します。このプロパティは、HotSpotMode 列挙値の 1 つを使用して設定します。有効値の一覧を次の表に示します。
| 項目 | |
|---|---|
| NotSet | HotSpot オブジェクトは、ImageMap コントロールの HotSpotMode プロパティで設定される動作を使用します。ImageMap コントロールで動作が定義されていない場合、HotSpot オブジェクトはすべて URL に移動します。 |
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 を設定します。
.gif) メモ |
|---|
| ImageMap コントロールの ImageMap.HotSpotMode プロパティ、またはそれに含まれる任意の HotSpot オブジェクトの HotSpot.HotSpotMode プロパティに HotSpotMode.NotSet を設定するか、または値を設定しない場合、既定の動作は HotSpotMode.Navigate となります。 |
使用例2 つの RectangleHotSpot オブジェクトを含む ImageMap コントロールを、宣言によって作成する方法を次のコード例に示します。ImageMap.HotSpotMode プロパティは HotSpotMode.PostBack に設定されます。この場合、ユーザーがいずれかのホット スポット領域をクリックするたびに、ページがサーバーにポストバックされます。RectangleHotSpot オブジェクトは ImageMap.HotSpotMode プロパティから動作を取得するため、それぞれのオブジェクトには HotSpotMode プロパティを設定しません。この例を正常に動作させるには、ImageUrl プロパティにユーザー独自のイメージを提供し、アプリケーションがそのイメージを見つけられるように、イメージへのパスを適切に更新する必要があります。
<%@ 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>
<%@ 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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照Weblioに収録されているすべての辞書からImageMap.HotSpotMode プロパティを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からImageMap.HotSpotMode プロパティ
を検索
- ImageMap.HotSpotMode プロパティのページへのリンク
