HotSpot.HotSpotMode 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得或設定按一下 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

其中一個 HotSpotMode 列舉值。 預設為 Default。

例外狀況

ArgumentOutOfRangeException

指定的型別不是其中一個 HotSpotMode 列舉值。

備註

HotSpotMode使用 屬性，即可在按一下 時 HotSpot 指定 控制項中 ImageMap 物件的行為 HotSpot 。 此屬性是使用其中 HotSpotMode 一個列舉值來設定。 下表列出可能的值。

值 描述
NotSet HotSpot 使用由 ImageMap 控制項的 HotSpotMode 屬性所設定的行為。 ImageMap如果控制項未定義行為，則物件會 HotSpot 巡覽至 URL。
Inactive HotSpot 沒有任何行為。
Navigate HotSpot 巡覽至 URL。
PostBack HotSpot 產生回傳給伺服器。

您可以在 控制項的 屬性或每個個別 HotSpot 物件的 屬性上 HotSpotMode 指定 HotSpot 行為 HotSpotMode 。 如果同時設定這兩個屬性， HotSpotMode 則每個個別 HotSpot 物件上指定的屬性會優先于 HotSpotMode 控制項上的 ImageMap 屬性。

如果您為 HotSpotMode 個別物件的 屬性指定 HotSpotMode.NotSet ，則會 HotSpot 從包含 ImageMap 控制項的 HotSpotMode 屬性取得其 HotSpot 行為。 在此案例中，如果 ImageMap 控制項的 HotSpotMode 屬性未設定為值或設定 HotSpotMode.NotSet 為 ，則預設行為是巡覽至 URL。

如果您指定 HotSpotMode.NavigateHotSpotMode 物件的 屬性 HotSpot ，當 HotSpot 按一下作用點區域時，物件會巡覽至 URL。 NavigateUrl使用 屬性指定要巡覽至的 URL。

如果您指定 HotSpotMode.PostBackHotSpotMode 物件的 屬性 HotSpot ，當 HotSpot 按一下 時 HotSpot ，物件會產生回傳至伺服器。 PostBackValue使用 屬性指定 的名稱 HotSpot 。 當發生回傳事件時， ImageMapEventArgs 此名稱將會在 的事件資料中傳遞。 按一下回 HotSpot 傳時， Click 就會引發 事件。 若要以程式設計方式控制按一下回 HotSpot 傳時所執行的動作，請提供事件的事件處理常式 Click 。

若要讓控制項中的所有 HotSpotImageMap 物件都有相同的行為，請將 HotSpot.HotSpotMode 每個個別 HotSpot 物件的 屬性設定為 HotSpotMode.NotSet 或未指定 屬性的值 HotSpot.HotSpotMode 。

若要為 HotSpot 控制項中的 ImageMap 物件指定不同的行為，請將 HotSpot.HotSpotMode 每個個別 HotSpot 物件的 屬性設定為 HotSpotMode.Navigate 、 HotSpotMode.PostBack 或 HotSpotMode.Inactive 。

注意

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>

適用於

另請參閱