HotSpot.HotSpotMode Свойство

Определение

Возвращает или задает поведение объекта HotSpot в элементе управления ImageMap при щелчке HotSpot.Gets or sets the behavior of a HotSpot object in an ImageMap control when the HotSpot is clicked.

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.One of the HotSpotMode enumeration values. Значение по умолчанию — Default.The default is Default.

Исключения

Указанный тип не является одним из значений перечисления HotSpotMode.The specified type is not one of the HotSpotMode enumeration values.

Комментарии

Используйте HotSpotMode свойство, чтобы указать поведение HotSpot объекта в ImageMap элементе управления при HotSpot щелчке.Use the HotSpotMode property to specify the behavior of a HotSpot object in an ImageMap control when the HotSpot is clicked. Это свойство задается с помощью одного из HotSpotMode значений перечисления.This property is set using one of the HotSpotMode enumeration values. В следующей таблице перечислены возможные значения.The following table lists the possible values.

ЗначениеValue ОписаниеDescription
NotSet Объект HotSpot реализует поведение, заданное в элементе управления ImageMap свойством HotSpotMode.The HotSpot uses the behavior set by the ImageMap control's HotSpotMode property. Если ImageMap элемент управления не определяет поведение, HotSpot объекты переходят по URL-адресу.If the ImageMap control does not define the behavior, the HotSpot objects navigate to a URL.
Inactive Объект HotSpot не характеризуется определенным поведением.The HotSpot does not have any behavior.
Navigate Объект HotSpot выполняет переход по URL-адресу.The HotSpot navigates to a URL.
PostBack Объект HotSpot осуществляет обратную передачу на сервер.The HotSpot generates a postback to the server.

Поведение можно указать HotSpot либо для HotSpotMode свойства элемента управления, либо для HotSpotMode свойства каждого отдельного HotSpot объекта.You can specify HotSpot behavior on either the HotSpotMode property of the control or on the HotSpotMode property of each individual HotSpot object. Если заданы оба свойства, то HotSpotMode свойство, заданное для каждого отдельного HotSpot объекта, имеет приоритет над HotSpotMode свойством ImageMap элемента управления.If both properties are set, the HotSpotMode property specified on each individual HotSpot object takes precedence over the HotSpotMode property on the ImageMap control.

Если указать HotSpotMode.NotSet для HotSpotMode свойства отдельного HotSpot объекта, объект HotSpot получает его поведение из свойства содержащего его ImageMap элемента управления HotSpotMode .If you specify HotSpotMode.NotSet for the HotSpotMode property of an individual HotSpot object, the HotSpot gets its behavior from the containing ImageMap control's HotSpotMode property. В этом случае, если ImageMap HotSpotMode свойству элемента управления не присвоено значение или задано HotSpotMode.NotSet , поведением по умолчанию является переход по URL-адресу.In this scenario, if the ImageMap control's HotSpotMode property is either not set to a value or is set to HotSpotMode.NotSet, the default behavior is to navigate to a URL.

Если указать HotSpotMode.Navigate для HotSpotMode свойства HotSpot объекта, HotSpot объект переходит по URL-адресу при нажатии на активную область.If you specify HotSpotMode.Navigate for the HotSpotMode property of a HotSpot object, the HotSpot object navigates to a URL when the hot spot region is clicked. Используйте NavigateUrl свойство, чтобы указать URL-адрес для перехода.Use the NavigateUrl property to specify the URL to navigate to.

Если указать HotSpotMode.PostBack для HotSpotMode свойства HotSpot объекта, HotSpot объект создает обратную передачу на сервер при HotSpot нажатии кнопки.If you specify HotSpotMode.PostBack for the HotSpotMode property of a HotSpot object, the HotSpot object generates a post back to the server when the HotSpot is clicked. Используйте PostBackValue свойство, чтобы указать имя для HotSpot .Use the PostBackValue property to specify a name for the HotSpot. Это имя будет передано в ImageMapEventArgs данные события в момент возникновения события обратной передачи.This name will be passed in the ImageMapEventArgs event data on when a postback event occurs. При нажатии обратной передачи HotSpot Click возникает событие.When a postback HotSpot is clicked, the Click event is raised. Для программного управления действиями, выполняемыми при нажатии обратной передачи HotSpot , предоставьте обработчик событий для Click события.To programmatically control the actions performed when a postback HotSpot is clicked, provide an event handler for the Click event.

Чтобы все HotSpot объекты в ImageMap элементе управления имели одинаковое поведение, установите HotSpot.HotSpotMode свойство для каждого отдельного HotSpot объекта HotSpotMode.NotSet или не указывайте значение для HotSpot.HotSpotMode Свойства.To cause all HotSpot objects in an ImageMap control to have the same behavior, set the HotSpot.HotSpotMode property on each individual HotSpot object to HotSpotMode.NotSet or do not specify a value for the HotSpot.HotSpotMode property.

Чтобы задать различные поведения для HotSpot объектов в ImageMap элементе управления, задайте HotSpot.HotSpotMode для свойства каждого отдельного HotSpot объекта значение HotSpotMode.Navigate , HotSpotMode.PostBack или HotSpotMode.Inactive .To specify different behaviors for HotSpot objects in an ImageMap control, set the HotSpot.HotSpotMode property on each individual HotSpot object to either HotSpotMode.Navigate, HotSpotMode.PostBack, or HotSpotMode.Inactive.

Примечание

Если ImageMap свойство элемента управления ImageMap.HotSpotMode или HotSpot.HotSpotMode свойство для HotSpot содержащихся в нем объектов не имеет значения или имеет значение HotSpotMode.NotSet , по умолчанию используется HotSpotMode.Navigate .If an ImageMap control's ImageMap.HotSpotMode property or the HotSpot.HotSpotMode property on the HotSpot objects it contains is either not set to a value or set to HotSpotMode.NotSet, by default the behavior is HotSpotMode.Navigate.

Если указать HotSpotMode.Inactive для HotSpot.HotSpotMode свойства, объект не будет HotSpot иметь поведения при щелчке.If you specify HotSpotMode.Inactive for the HotSpot.HotSpotMode property, the HotSpot object does not have any behavior when it is clicked. Это значение можно использовать для создания неактивной активной зоны в более крупной активной горячей точке.You can use this value to create an inactive hot spot within a larger active hot spot. Этот параметр позволяет создавать более сложные зоны горячей замены в пределах ImageMap элемента управления.This option is provided to allow you to create more complex hot-spot zones within an ImageMap control.

Чтобы создать неактивную область внутри активной горячей точки, необходимо указать неактивную активную точку, прежде чем активировать активную точку в ImageMap элементе управления.To create an inactive area within an active hot spot, you must specify the inactive hot spot before the active hot spot in the ImageMap control. Например, в следующем примере ImageMap определяется активное кольцо путем указания неактивной круговой горячей точки в более крупной активной замкнутой точке:For example, the following ImageMap defines an active ring by specifying an inactive circular hot spot within a larger active circular hot spot:

<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>

Применяется к

См. также раздел