ImageMap.HotSpotMode-Eigenschaft

Verwenden Sie die HotSpotMode-Eigenschaft, um auf das standardmäßige Verhalten der HotSpot-Objekten in einem ImageMap-Steuerelements anzugeben. Diese Eigenschaft wird mit einem der HotSpotMode-Enumerationswerte festgelegt. In der folgenden Tabelle sind die möglichen Werte aufgeführt.

Sie können das Verhalten eines HotSpot-Objekts mit einem geben die Eigenschaft des Steuerelements ImageMapImageMap.HotSpotMode oder die HotSpot.HotSpotMode-Eigenschaft jedes einzelnen HotSpot-Objekts. Wenn beide Eigenschaften festgelegt werden, hat die HotSpot.HotSpotMode-Eigenschaft, die für jedes einzelne HotSpot-Objekt angegeben ist, Vorrang vor der ImageMap.HotSpotMode-Eigenschaft auf dem ImageMap-Steuerelement.

Wenn Sie die HotSpotMode-Eigenschaft des ImageMap-Steuerelements, und beachten, dass die HotSpotMode.NotSet das gleiche Verhalten HotSpotMode.Navigate-Werte haben: beides zu einer URL navigiert. Wenn Sie HotSpotMode.NotSet für die HotSpot.HotSpotMode-Eigenschaft eines einzelnen HotSpot-Objekts angeben, bestimmt diese HotSpot dessen Verhalten vom Wert der HotSpotMode-Eigenschaft des ImageMap-Steuerelements.

Wenn Sie HotSpotMode.Navigate für die ImageMap.HotSpotMode-Eigenschaft angeben, navigiert die Seite zu einer URL ein, wenn auf HotSpot geklickt wird. Verwenden Sie die NavigateUrl-Eigenschaft können Sie die URL festlegen, zu dem navigiert werden soll.

Wenn Sie HotSpotMode.PostBack für die ImageMap.HotSpotMode-Eigenschaft angeben, generiert die Seite ein Postback an den Server, wenn auf HotSpot geklickt wird. Verwenden Sie die PostBackValue-Eigenschaft, um den Namen des Bereichs Hotspot angeben. Dieser Name wird in der ImageMapEventArgs-Ereignisdaten übergeben, wenn ein Postbackereignis eintritt. Wenn auf ein Postback HotSpot geklickt wird, wird das Click-Ereignis ausgelöst. Um die ausgeführten Aktionen programmgesteuert zu steuern, wenn auf ein Postback HotSpot geklickt wird, erstellen Sie einen Ereignishandler für das Click-Ereignis bereit.

Wenn Sie HotSpotMode.Inactive für die HotSpot.HotSpotMode-Eigenschaft festlegen, hat das HotSpot-Objekt kein Verhalten, 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, können Sie komplexere Hotspot zonen innerhalb eines Steuerelements erstellen ImageMap bereitgestellt.

Um einen inaktiven Bereich innerhalb eines aktiven Hotspots zu erstellen, müssen Sie den inaktiven Hotspot angeben, bevor der aktiven Hotspot im ImageMap-Steuerelement. Zum Beispiel definiert der folgenden ImageMap einen aktiven Ring, indem sie einen inaktiven kreisförmigen Hotspot innerhalb eines größeren aktiven kreisförmigen Hotspots angeben:

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

Um alle HotSpot-Objekte in einem ImageMap-Steuerelement führen zum selben Verhalten aufweist, verwenden Sie die HotSpotMode-Eigenschaft auf dem ImageMap-Steuerelement um das Verhalten anzugeben. Anschließend legen Sie entweder die HotSpotMode-Eigenschaft für jedes einzelne HotSpot-Objekt fest HotSpotMode.NotSet oder geben Sie keinen Wert für die HotSpot.HotSpotMode-Eigenschaft an.

Um ein anderes Verhalten für HotSpot-Objekte in einem ImageMap-Steuerelement anzugeben, legen Sie die HotSpot.HotSpotMode-Eigenschaft für jedes einzelne HotSpot-Objekt entweder auf HotSpotMode.Navigate, HotSpotMode.PostBackoder HotSpotMode.Inactivefest.

Hinweis
Wenn ImageMap.HotSpotMode-Eigenschaft eines Steuerelements ImageMap oder die HotSpot.HotSpotMode-Eigenschaft auf einen der HotSpot-Objekte, die sie ist entweder der Menge HotSpotMode.NotSet enthält oder nicht auf einen Wert festgelegt ist, standardmäßig das Verhalten HotSpotMode.Navigate.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie deklarativ ImageMap ein Steuerelement erstellen, das zwei RectangleHotSpot-Objekte enthält. Die ImageMap.HotSpotMode-Eigenschaft wird auf HotSpotMode.PostBackfestgelegt, die bewirkt, dass die Seite an den Server zurückgesendet wird, sobald ein Benutzer, der auf einen der Hotspotbereiche klickt. Die HotSpotMode-Eigenschaft wird nicht für jedes der RectangleHotSpot-Objekte festgelegt, da sie ihr Verhalten aus der ImageMap.HotSpotMode-Eigenschaft abrufen. Damit dieses Beispiel wie vorgesehen funktioniert, müssen Sie angeben, ImageUrl Bild für die Eigenschaft besitzen und den Pfad zu dem Bild entsprechend zu aktualisieren, damit die Anwendung sie gefunden werden kann.

<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void VoteMap_Clicked(object sender, ImageMapEventArgs e)
  {       
    // When a user clicks the "Yes" hot spot,
    // display the hot spot's value.
    if (e.PostBackValue == "Yes")
      Message1.Text = "You selected " + e.PostBackValue + ".";

    else if (e.PostBackValue == "No") 
      // When a user clicks the "No" hot spot,
      // display the hot spot's value.       
      Message1.Text = "You selected " + e.PostBackValue + ".";

    else
      Message1.Text = "You did not click a valid hot spot region.";             
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap.HotSpotMode Example</title>
</head>
  <body>
    <form id="form1" runat="server">

      <h3>ImageMap.HotSpotMode Example</h3>

      <!--The RectangleHotSpot objects have the post back
        behavior specified by the HotSpotMode 
        property on the ImageMap control.-->
      <asp:imagemap id="Vote"           
        imageurl="Images/VoteImage.jpg"
        alternatetext="Voting choices" 
        hotspotmode="PostBack"
        onclick="VoteMap_Clicked"   
        runat="Server">   

        <asp:RectangleHotSpot          
          top="0"
          left="0"
          bottom="354"
          right="250"
          postbackvalue="Yes"
          alternatetext="Vote yes">
        </asp:RectangleHotSpot>

        <asp:RectangleHotSpot 
          top="0"
          left="251"
          bottom="354"
          right="500"
          postbackvalue="No"
          alternatetext="Vote no">
        </asp:RectangleHotSpot>

      </asp:imagemap>

      <br />

      <asp:label id="Message1"
        runat="Server">
      </asp:label>

    </form>      
  </body>
</html>

.NET Framework

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz

Weitere Ressourcen