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使用 属性指定 控件中ImageMap对象的行为HotSpotHotSpot 此属性是使用枚举值之一设置的 HotSpotMode 。 下表列出了可能的值。

说明
NotSet HotSpot 使用由 ImageMap 控件的 HotSpotMode 属性设置的行为。 ImageMap如果控件未定义行为,则HotSpot对象将导航到 URL。
Inactive HotSpot 不具有任何行为。
Navigate HotSpot 定位到 URL。
PostBack HotSpot 生成到服务器的回发。

可以在控件的 属性或每个单独HotSpot对象的 属性上HotSpotMode指定HotSpot行为HotSpotMode。 如果这两个属性都已设置,则 HotSpotMode 针对每个单独 HotSpot 对象指定的属性优先于 HotSpotMode 控件上的 ImageMap 属性。

如果 HotSpotMode.NotSet 指定 HotSpotMode 单个 HotSpot 对象的 属性,则 HotSpot 从包含 ImageMap 控件的 HotSpotMode 属性获取其行为。 在此方案中,如果 ImageMap 控件的 HotSpotMode 属性未设置为值或设置为 HotSpotMode.NotSet,则默认行为是导航到 URL。

如果为 HotSpotMode 对象的 属性HotSpot指定HotSpotMode.Navigate,则HotSpot单击热点区域时,对象将导航到 URL。 NavigateUrl使用 属性指定要导航到的 URL。

如果为 HotSpotMode 对象的 属性HotSpot指定 HotSpotMode.PostBack ,则当单击 时HotSpotHotSpot对象会生成回服务器的回发。 PostBackValue使用 属性指定 的名称HotSpot。 发生回发事件时, ImageMapEventArgs 将在事件数据中传递此名称。 单击回发 HotSpot 时,将 Click 引发 事件。 若要以编程方式控制单击回发 HotSpot 时执行的操作,请为 Click 事件提供事件处理程序。

若要使控件中的所有HotSpotImageMap对象具有相同的行为,请将每个单个HotSpot对象的 属性设置为 HotSpot.HotSpotModeHotSpotMode.NotSet 或不指定HotSpot.HotSpotMode属性的值。

若要为HotSpot控件中的ImageMap对象指定不同的行为,请将每个单个HotSpot对象的 属性设置为 HotSpot.HotSpotModeHotSpotMode.NavigateHotSpotMode.PostBackHotSpotMode.Inactive

注意

如果控件ImageMap的 属性或HotSpot.HotSpotMode它包含的对象上的 HotSpot 属性未设置为 值或设置为 HotSpotMode.NotSet,则默认情况下行为为 HotSpotMode.NavigateImageMap.HotSpotMode

如果为 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>

适用于

另请参阅