HotSpot.HotSpotMode プロパティ

public:
 virtual property System::Web::UI::WebControls::HotSpotMode HotSpotMode { System::Web::UI::WebControls::HotSpotMode get(); void set(System::Web::UI::WebControls::HotSpotMode value); };

public virtual System.Web.UI.WebControls.HotSpotMode HotSpotMode { get; set; }

member this.HotSpotMode : System.Web.UI.WebControls.HotSpotMode with get, set

Public Overridable Property HotSpotMode As HotSpotMode

プロパティ値

HotSpotMode列挙値の 1 つ。 既定値は Default です。

例外

注釈

HotSpotMode プロパティを使用して、HotSpotをクリックしたときのImageMap コントロール内のHotSpot オブジェクトの動作を指定します。 このプロパティは、 HotSpotMode 列挙値のいずれかを使用して設定されます。 次の表に、使用可能な値の一覧を示します。

HotSpot動作は、コントロールの HotSpotMode プロパティ、または個々のHotSpotMode オブジェクトの HotSpot プロパティで指定できます。 両方のプロパティが設定されている場合、個々のHotSpotMode オブジェクトで指定されたHotSpot プロパティが、HotSpotMode コントロールのImageMap プロパティよりも優先されます。

個々のHotSpotMode.NotSet オブジェクトのHotSpotMode プロパティにHotSpotを指定すると、HotSpotは、含まれているImageMap コントロールのHotSpotMode プロパティから動作を取得します。 このシナリオでは、 ImageMap コントロールの HotSpotMode プロパティが値に設定されていないか、 HotSpotMode.NotSetに設定されている場合、既定の動作は URL に移動することです。

HotSpotMode.Navigate オブジェクトのHotSpotMode プロパティにHotSpotを指定すると、ホット スポット領域がクリックされたときに、HotSpot オブジェクトは URL に移動します。 NavigateUrl プロパティを使用して、移動する URL を指定します。

HotSpotMode.PostBack オブジェクトのHotSpotMode プロパティにHotSpotを指定すると、HotSpot オブジェクトは、HotSpotがクリックされたときにサーバーへのポストバックを生成します。 PostBackValueの名前を指定するには、HotSpot プロパティを使用します。 この名前は、ポストバック イベントが発生したときに ImageMapEventArgs イベント データに渡されます。 ポストバック HotSpot がクリックされると、 Click イベントが発生します。 ポストバック HotSpot がクリックされたときに実行されるアクションをプログラムで制御するには、 Click イベントのイベント ハンドラーを指定します。

HotSpot コントロール内のすべてのImageMap オブジェクトの動作を同じにするには、個々のHotSpot.HotSpotMode オブジェクトのHotSpot プロパティをHotSpotMode.NotSetに設定するか、HotSpot.HotSpotMode プロパティの値を指定しないでください。

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

HotSpotMode.Inactive プロパティにHotSpot.HotSpotModeを指定した場合、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>

こちらもご覧ください

• HotSpotMode
• ImageMap
• HotSpotMode
• ImageMap Web サーバー コントロール