Udostępnij za pośrednictwem

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

Jedna z HotSpotMode 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 Używa HotSpot 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.

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

Jeśli określisz HotSpotMode.NotSetHotSpotMode właściwość pojedynczego HotSpot obiektu, HotSpot jego zachowanie zostanie wyświetlone z właściwości zawierającej ImageMap kontrolkę HotSpotMode . W tym scenariuszu, jeśli ImageMap właściwość kontrolki HotSpotMode nie jest ustawiona na wartość lub jest ustawiona na HotSpotMode.NotSetwartość , domyślnym zachowaniem jest przejście do adresu URL.

Jeśli określisz HotSpotMode.Navigate właściwość HotSpotModeHotSpot obiektu, HotSpot obiekt przechodzi do adresu URL po kliknięciu regionu miejsca gorącego. Użyj właściwości , NavigateUrl aby określić adres URL do przejścia.

Jeśli określisz HotSpotMode.PostBack właściwość HotSpotModeHotSpot obiektu, HotSpot obiekt generuje wpis z powrotem do serwera po kliknięciu HotSpot obiektu. Użyj właściwości , PostBackValue aby określić nazwę elementu HotSpot. Ta nazwa zostanie przekazana w danych zdarzenia w przypadku wystąpienia zdarzenia po wystąpieniu ImageMapEventArgs zdarzenia zwrotnego. Po kliknięciu po powrocie zwrotne HotSpot zdarzenie zostanie podniesione Click . Aby programowo kontrolować akcje wykonywane po kliknięciu postbacku HotSpot , podaj procedurę obsługi zdarzeń Click dla 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 HotSpotMode.NotSet na wartość lub nie określić wartości właściwości HotSpot.HotSpotMode .

Aby określić różne zachowania dla HotSpot obiektów w kontrolceImageMap, ustaw HotSpot.HotSpotMode właściwość dla każdego obiektu HotSpotHotSpotMode.Navigatena wartość , lub HotSpotMode.PostBackHotSpotMode.Inactive.

Uwaga

ImageMap Jeśli właściwość kontrolki ImageMap.HotSpotMode lub HotSpot.HotSpotMode właściwość w obiektach, które HotSpot 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 miejsca 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ć obszar nieaktywny w aktywnym miejscu gorącym, należy określić nieaktywne miejsce gorące przed aktywnym miejscem gorącym w kontrolce ImageMap . Na przykład następujące ImageMap definicje aktywnego pierścienia przez określenie nieaktywnego cyklicznego miejsca gorącego w większym aktywnym cyklicznym 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ż