HotSpot.HotSpotMode Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia zachowanie HotSpot obiektu w kontrolce ImageMap po kliknięciu 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

Wartość właściwości

HotSpotMode

HotSpotMode Jedna z wartości wyliczenia. Wartość domyślna to Default.

Wyjątki

ArgumentOutOfRangeException

Określony typ nie jest jedną z HotSpotMode wartości wyliczenia.

Uwagi

HotSpotMode Użyj właściwości , aby określić zachowanie HotSpot obiektu w kontrolce ImageMap po kliknięciuHotSpot. Ta właściwość jest ustawiana przy użyciu jednej z HotSpotMode wartości wyliczenia. W poniższej tabeli wymieniono możliwe wartości.

Wartość Opis
NotSet Obiekt HotSpot używa zachowania ustawionego ImageMap przez właściwość kontrolki HotSpotMode . Jeśli kontrolka ImageMap nie definiuje zachowania, HotSpot obiekty przechodzą do adresu URL.
Inactive Element HotSpot nie ma żadnego zachowania.
Navigate Spowoduje HotSpot to przejście do adresu URL.
PostBack Element HotSpot generuje powrót do serwera.

Można określić HotSpot zachowanie dla HotSpotMode właściwości kontrolki lub HotSpotMode właściwości każdego pojedynczego HotSpot obiektu. Jeśli obie właściwości są ustawione, HotSpotMode właściwość określona dla każdego pojedynczego HotSpot obiektu ma pierwszeństwo przed właściwością HotSpotMode kontrolki ImageMap .

Jeśli określisz właściwość pojedynczego HotSpot obiektu, HotSpot jego zachowanie zostanie odebrane z właściwości kontrolki zawierającej HotSpotModeImageMap.HotSpotMode.NotSetHotSpotMode W tym scenariuszu, jeśli ImageMap właściwość kontrolki HotSpotMode nie jest ustawiona na wartość lub jest ustawiona na HotSpotMode.NotSetwartość , domyślne zachowanie polega na przejściu do adresu URL.

Jeśli określisz HotSpotMode.NavigateHotSpotMode właściwość HotSpot obiektu, HotSpot obiekt przechodzi do adresu URL po kliknięciu regionu hot spot. NavigateUrl Użyj właściwości , aby określić adres URL do przejścia.

Jeśli określisz HotSpotMode.PostBackHotSpotMode właściwość HotSpot obiektu, HotSpot obiekt wygeneruje wpis z powrotem na serwerze po kliknięciu HotSpot obiektu. PostBackValue Użyj właściwości , aby określić nazwę obiektu HotSpot. Ta nazwa zostanie przekazana ImageMapEventArgs w danych zdarzenia, gdy wystąpi zdarzenie ogłaszania zwrotnego. Po kliknięciu Click ogłaszania zwrotnego HotSpot zdarzenie jest zgłaszane. Aby programowo kontrolować akcje wykonywane po kliknięciu ogłaszania zwrotnego HotSpot , podaj procedurę obsługi zdarzeń dla Click zdarzenia.

Aby spowodować, że wszystkie HotSpot obiekty w kontrolce ImageMap mają takie samo zachowanie, ustaw HotSpot.HotSpotMode właściwość dla każdego pojedynczego HotSpot obiektu na HotSpotMode.NotSet wartość lub nie określij wartości właściwości HotSpot.HotSpotMode .

Aby określić różne zachowania obiektów HotSpot w kontrolce ImageMap , ustaw HotSpot.HotSpotMode właściwość dla każdego pojedynczego HotSpot obiektu na HotSpotMode.Navigatewartość , HotSpotMode.PostBacklub HotSpotMode.Inactive.

Uwaga

ImageMap Jeśli właściwość kontrolki ImageMap.HotSpotMode lub HotSpot.HotSpotMode właściwość w HotSpot obiektach, które zawiera, nie jest ustawiona na wartość lub ustawiona na HotSpotMode.NotSetwartość , domyślnie zachowanie to HotSpotMode.Navigate.

Jeśli określisz HotSpotMode.Inactive właściwość , HotSpot obiekt nie ma żadnego zachowania po kliknięciuHotSpot.HotSpotMode. Tej wartości można użyć do utworzenia nieaktywnego punktu gorącego w większym aktywnym miejscu gorącym. Ta opcja umożliwia tworzenie bardziej złożonych stref typu hot-spot w ramach kontrolki ImageMap .

Aby utworzyć nieaktywny obszar w aktywnym miejscu dostępu, należy określić nieaktywne miejsce dostępu przed aktywnym miejscem dostępu w kontrolce ImageMap . Na przykład następujące ImageMap elementy definiują aktywny pierścień, określając nieaktywny okrągły punkt dostępu w większym aktywnym okrągłym miejscu gorącym:

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

Dotyczy

Zobacz też