HotSpot.HotSpotMode Eigenschaft

Definition

Gibt das Verhalten eines HotSpot-Objekts in einem ImageMap-Steuerelement beim Klicken auf den HotSpot an oder legt dieses fest.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

Eigenschaftswert

Einer der HotSpotMode-Enumerationswerte.One of the HotSpotMode enumeration values. Der Standardwert lautet Default.The default is Default.

Ausnahmen

Der angegebene Typ ist kein HotSpotMode-Enumerationswert.The specified type is not one of the HotSpotMode enumeration values.

Hinweise

Verwenden Sie die HotSpotMode-Eigenschaft, um das Verhalten eines HotSpot Objekts in einem ImageMap-Steuerelement anzugeben, wenn auf das HotSpot geklickt wird.Use the HotSpotMode property to specify the behavior of a HotSpot object in an ImageMap control when the HotSpot is clicked. Diese Eigenschaft wird mit einem der HotSpotMode Enumerationswerte festgelegt.This property is set using one of the HotSpotMode enumeration values. In der folgenden Tabelle sind die möglichen Werte aufgeführt.The following table lists the possible values.

valueValue BESCHREIBUNGDescription
NotSet HotSpot verwendet das Verhalten, das durch die ImageMap-Eigenschaft des HotSpotMode-Steuerelements festgelegt wurde.The HotSpot uses the behavior set by the ImageMap control's HotSpotMode property. Wenn das ImageMap Steuerelement das Verhalten nicht definiert, navigieren die HotSpot Objekte zu einer URL.If the ImageMap control does not define the behavior, the HotSpot objects navigate to a URL.
Inactive Der HotSpot verfügt über kein Verhalten.The HotSpot does not have any behavior.
Navigate HotSpot navigiert zu einer URL.The HotSpot navigates to a URL.
PostBack HotSpot generiert ein Postback an den Server.The HotSpot generates a postback to the server.

Sie können HotSpot Verhalten entweder für die HotSpotMode-Eigenschaft des Steuer Elements oder für die HotSpotMode-Eigenschaft jedes einzelnen HotSpot Objekts angeben.You can specify HotSpot behavior on either the HotSpotMode property of the control or on the HotSpotMode property of each individual HotSpot object. Wenn beide Eigenschaften festgelegt sind, hat die HotSpotMode-Eigenschaft, die auf jedem einzelnen HotSpot-Objekt angegeben wird, Vorrang vor der HotSpotMode-Eigenschaft des ImageMap Steuer Elements.If both properties are set, the HotSpotMode property specified on each individual HotSpot object takes precedence over the HotSpotMode property on the ImageMap control.

Wenn Sie HotSpotMode.NotSet für die HotSpotMode-Eigenschaft eines einzelnen HotSpot Objekts angeben, wird das Verhalten des HotSpot von der ImageMap-Eigenschaft des enthaltenden HotSpotMode Steuer Elements abgerufen.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. Wenn in diesem Szenario die HotSpotMode-Eigenschaft des ImageMap-Steuer Elements entweder nicht auf einen Wert festgelegt oder auf HotSpotMode.NotSetfestgelegt ist, besteht das Standardverhalten darin, zu einer URL zu navigieren.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.

Wenn Sie HotSpotMode.Navigate für die HotSpotMode-Eigenschaft eines HotSpot Objekts angeben, navigiert das HotSpot Objekt zu einer URL, wenn auf den Hotspot Bereich geklickt wird.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. Verwenden Sie die Eigenschaft NavigateUrl, um die URL anzugeben, zu der navigiert werden soll.Use the NavigateUrl property to specify the URL to navigate to.

Wenn Sie HotSpotMode.PostBack für die HotSpotMode-Eigenschaft eines HotSpot Objekts angeben, generiert das HotSpot Objekt beim Klicken auf den HotSpot ein Postback an den Server.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. Verwenden Sie die PostBackValue-Eigenschaft, um einen Namen für die HotSpotanzugeben.Use the PostBackValue property to specify a name for the HotSpot. Dieser Name wird in den ImageMapEventArgs Ereignisdaten beim Auftreten eines Post Back Ereignisses weitergegeben.This name will be passed in the ImageMapEventArgs event data on when a postback event occurs. Wenn auf ein Postback HotSpot geklickt wird, wird das Click-Ereignis ausgelöst.When a postback HotSpot is clicked, the Click event is raised. Um die Aktionen Programm gesteuert zu steuern, die ausgeführt werden, wenn auf ein Postback HotSpot geklickt wird, stellen Sie einen Ereignishandler für das Click Ereignis bereit.To programmatically control the actions performed when a postback HotSpot is clicked, provide an event handler for the Click event.

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

Wenn Sie unterschiedliche Verhalten für HotSpot Objekte in einem ImageMap-Steuerelement angeben möchten, legen Sie für die Eigenschaft HotSpot.HotSpotMode jedes einzelnen HotSpot Objekts entweder HotSpotMode.Navigate, HotSpotMode.PostBackoder HotSpotMode.Inactivefest.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.

Hinweis

Wenn die ImageMap.HotSpotMode-Eigenschaft eines ImageMap-Steuer Elements oder die HotSpot.HotSpotMode-Eigenschaft für die darin enthaltenen HotSpot Objekte entweder nicht auf einen Wert festgelegt oder auf HotSpotMode.NotSetfestgelegt ist, ist das Verhalten standardmäßig 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.

Wenn Sie HotSpotMode.Inactive für die HotSpot.HotSpotMode-Eigenschaft angeben, weist das HotSpot-Objekt kein Verhalten auf, wenn darauf geklickt wird.If you specify HotSpotMode.Inactive for the HotSpot.HotSpotMode property, the HotSpot object does not have any behavior when it is clicked. Sie können diesen Wert verwenden, um einen inaktiven Hotspot innerhalb eines größeren aktiven Hotspots zu erstellen.You can use this value to create an inactive hot spot within a larger active hot spot. Diese Option wird bereitgestellt, damit Sie komplexere Hotspot Zonen in einem ImageMap-Steuerelement erstellen können.This option is provided to allow you to create more complex hot-spot zones within an ImageMap control.

Um einen inaktiven Bereich innerhalb eines aktiven Hotspots zu erstellen, müssen Sie den inaktiven Hotspot vor dem aktiven Hotspot im ImageMap Steuerelement angeben.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. Im folgenden ImageMap wird z. b. ein aktiver Ring definiert, indem in einem größeren aktiven Zirkel Hotspot ein inaktiver Ring festgelegt wird: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>

Gilt für:

Siehe auch