共用方式為

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>

適用於

另請參閱