HotSpot.HotSpotMode プロパティ

定義

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

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 列挙値のいずれか。 既定値は、Default です。

例外

指定した型が HotSpotMode 列挙値ではありません。

注釈

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

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

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

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

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

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

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

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

注意

ImageMapコントロールの ImageMap.HotSpotMode プロパティまたはHotSpot.HotSpotModeコントロールに含まれるオブジェクトの HotSpot プロパティが 値に設定されていないか、 にHotSpotMode.NotSet設定されていない場合、既定では動作は ですHotSpotMode.Navigate

プロパティに 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>

適用対象

こちらもご覧ください