HotSpot.HotSpotMode Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Gibt das Verhalten eines HotSpot-Objekts in einem ImageMap-Steuerelement beim Klicken auf den HotSpot an oder legt dieses fest.

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

Eigenschaftswert

HotSpotMode

Einer der HotSpotMode-Enumerationswerte. Der Standardwert ist Default.

Ausnahmen

ArgumentOutOfRangeException

Der angegebene Typ ist kein HotSpotMode-Enumerationswert.

Hinweise

Verwenden Sie die HotSpotMode -Eigenschaft, um das Verhalten eines HotSpot Objekts in einem ImageMap Steuerelement anzugeben, wenn auf das HotSpot geklickt wird. Diese Eigenschaft wird mithilfe eines der HotSpotMode Enumerationswerte festgelegt. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Wert	BESCHREIBUNG
NotSet	HotSpot verwendet das Verhalten, das durch die ImageMap-Eigenschaft des HotSpotMode-Steuerelements festgelegt wurde. Wenn das ImageMap -Steuerelement das Verhalten nicht definiert, navigieren die HotSpot Objekte zu einer URL.
Inactive	Der HotSpot verfügt über kein Verhalten.
Navigate	HotSpot navigiert zu einer URL.
PostBack	HotSpot generiert ein Postback an den Server.

Sie können das Verhalten entweder für die HotSpotMode -Eigenschaft des -Steuerelements oder für die HotSpotMode -Eigenschaft jedes einzelnen HotSpot Objekts angebenHotSpot. Wenn beide Eigenschaften festgelegt sind, hat die HotSpotMode für jedes einzelne HotSpot Objekt angegebene Eigenschaft Vorrang vor der HotSpotMode -Eigenschaft des -Steuerelements ImageMap .

Wenn Sie für die HotSpotMode -Eigenschaft eines einzelnen HotSpot Objekts angebenHotSpotMode.NotSet, ruft dessen HotSpot Verhalten von der -Eigenschaft des enthaltenden ImageMap Steuerelements HotSpotMode ab. Wenn die ImageMap Eigenschaft des Steuerelements HotSpotMode in diesem Szenario entweder nicht auf einen Wert oder auf HotSpotMode.NotSetfestgelegt ist, besteht das Standardverhalten darin, zu einer URL zu navigieren.

Wenn Sie für die HotSpotMode -Eigenschaft eines HotSpot Objekts angebenHotSpotMode.Navigate, navigiert das HotSpot Objekt zu einer URL, wenn auf den Hotspotbereich geklickt wird. Verwenden Sie die NavigateUrl -Eigenschaft, um die URL anzugeben, zu der navigiert werden soll.

Wenn Sie für die HotSpotMode -Eigenschaft eines HotSpot -Objekts angebenHotSpotMode.PostBack, generiert das HotSpot -Objekt einen Postback an den Server, wenn auf geklickt HotSpot wird. Verwenden Sie die PostBackValue -Eigenschaft, um einen Namen für anzugeben HotSpot. Dieser Name wird in den ImageMapEventArgs Ereignisdaten übergeben, wenn ein Postbackereignis auftritt. Wenn auf ein Postback HotSpot geklickt wird, wird das Click Ereignis ausgelöst. Stellen Sie einen Ereignishandler für das Ereignis bereit, um die Aktionen programmgesteuert zu steuern, die Click beim Klicken auf ein Postback HotSpot ausgeführt werden.

Damit alle HotSpot Objekte in einem ImageMap Steuerelement das gleiche Verhalten aufweisen, legen Sie die HotSpot.HotSpotMode -Eigenschaft für jedes einzelne HotSpot Objekt auf HotSpotMode.NotSet fest, oder geben Sie keinen Wert für die HotSpot.HotSpotMode -Eigenschaft an.

Um unterschiedliche Verhaltensweisen für HotSpot Objekte in einem ImageMap Steuerelement anzugeben, legen Sie die HotSpot.HotSpotMode -Eigenschaft für jedes einzelne HotSpot Objekt entweder HotSpotMode.Navigateauf , HotSpotMode.PostBackoder HotSpotMode.Inactivefest.

Hinweis

Wenn die -Eigenschaft eines ImageMap Steuerelements ImageMap.HotSpotMode oder die HotSpot.HotSpotMode -Eigenschaft in den HotSpot darin enthaltenen Objekten entweder nicht auf einen Wert festgelegt oder auf HotSpotMode.NotSetfestgelegt ist, lautet HotSpotMode.Navigatedas Verhalten standardmäßig .

Wenn Sie für die HotSpot.HotSpotMode -Eigenschaft angebenHotSpotMode.Inactive, weist das HotSpot Objekt kein Verhalten auf, wenn darauf geklickt wird. Sie können diesen Wert verwenden, um einen inaktiven Hotspot innerhalb eines größeren aktiven Hotspots zu erstellen. Diese Option wird bereitgestellt, damit Sie komplexere Hotspotzonen innerhalb eines Steuerelements ImageMap erstellen können.

Um einen inaktiven Bereich innerhalb eines aktiven Hotspots zu erstellen, müssen Sie den inaktiven Hotspot vor dem aktiven Hotspot im ImageMap Steuerelement angeben. Im Folgenden ImageMap wird beispielsweise ein aktiver Ring definiert, indem ein inaktiver kreisförmiger Hotspot innerhalb eines größeren aktiven kreisförmigen Hotspots angegeben wird:

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

Weitere Informationen

• HotSpotMode
• ImageMap
• HotSpotMode
• ImageMap-Webserversteuerelement