PolygonHotSpot Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Definiert einen polygonförmigen Hotspotbereich in einem ImageMap-Steuerelement. Diese Klasse kann nicht vererbt werden.

public ref class PolygonHotSpot sealed : System::Web::UI::WebControls::HotSpot

public sealed class PolygonHotSpot : System.Web.UI.WebControls.HotSpot

type PolygonHotSpot = class
    inherit HotSpot

Public NotInheritable Class PolygonHotSpot
Inherits HotSpot

Vererbung: Object

HotSpot
PolygonHotSpot

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein ImageMap Steuerelement erstellt wird, das drei PolygonHotSpot -Objekte enthält. Jedes PolygonHotSpot Objekt stellt eine geografische Region auf der Karte dar. Wenn der Benutzer auf ein PolygonHotSpot Objekt klickt, wird es an den Server zurückgepostet, und Typ und Name des Hotspots werden in einer Bezeichnung angezeigt.

<%@ 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 RegionMap_Clicked (object sender, ImageMapEventArgs e)
  {
    string hotSpotType;

    // When a user clicks a hot spot, display
    // the hot spot's type and name.
    switch (e.PostBackValue)
    {
      case "Western":
        hotSpotType = Regions.HotSpots[0].ToString();
        Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue;
        break;
        
      case "Northern":
        hotSpotType = Regions.HotSpots[1].ToString();
        Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue;
        break;

      case "Southern":
        hotSpotType = Regions.HotSpots[2].ToString();
        Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue;
        break;

      default:
        Message1.Text = "You did not click a valid hot spot region.";
        break;
    }
  }  
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>PolygonHotSpot Class Example</title>
</head>
  <body>
    <form id="Form1" runat="server">
    
      <h3>PolygonHotSpot Example</h3>
      
      <!-- Change or remove the width and height attributes as
           appropriate for your image. -->
      <asp:imagemap id="Regions"           
        imageurl="Images/RegionMap.jpg"
        alternatetext="Sales regions" 
        hotspotmode="PostBack"
        width="400"
        height="400"
        onclick="RegionMap_Clicked"   
        runat="Server">            
          
        <asp:PolygonHotSpot 
          coordinates="0,0,176,0,125,182,227,400,0,400"         
          postbackvalue="Western"
          alternatetext="Western Region">
        </asp:PolygonHotSpot>
          
        <asp:PolygonHotSpot 
          coordinates="177,0,400,0,400,223,335,154,127,180"         
          postbackvalue="Northern"
          alternatetext="Northern Region">
        </asp:PolygonHotSpot>
        
        <asp:PolygonHotSpot 
          coordinates="128,185,335,157,400,224,400,400,228,400"         
          postbackvalue="Southern"
          alternatetext="Southern Region">
        </asp:PolygonHotSpot>
      
      </asp:imagemap>
            
      <br /><br />
          
      <asp:label id="Message1"
        runat="Server">
      </asp:label>                 
                 
    </form>      
  </body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  
  Sub RegionMap_Clicked(ByVal sender As Object, ByVal e As ImageMapEventArgs)
    Dim hotSpotType As String
        
    ' When a user clicks a hot spot, display
    ' the hot spot's type and name.
    Select Case (e.PostBackValue)
      
      Case ("Western")
        hotSpotType = Regions.HotSpots(0).ToString()
        Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue
      
      Case ("Northern")
        hotSpotType = Regions.HotSpots(1).ToString()
        Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue
      
      Case ("Southern")
        hotSpotType = Regions.HotSpots(2).ToString()
        Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue
      
      Case Else
        Message1.Text = "You did not click a valid hot spot region."
    
    End Select

  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>PolygonHotSpot Class Example</title>
</head>
  <body>
    <form id="Form1" runat="server">
    
      <h3>PolygonHotSpot Example</h3>
      
      <!-- Change or remove the width and height attributes as
           appropriate for your image. -->
      <asp:imagemap id="Regions"           
        imageurl="Images/RegionMap.jpg"
        alternatetext="Sales regions" 
        hotspotmode="PostBack"
        width="400"
        height="400"
        onclick="RegionMap_Clicked"   
        runat="Server">            
          
        <asp:PolygonHotSpot 
          coordinates="0,0,176,0,125,182,227,400,0,400"         
          postbackvalue="Western"
          alternatetext="Western Region">
        </asp:PolygonHotSpot>
          
        <asp:PolygonHotSpot 
          coordinates="177,0,400,0,400,223,335,154,127,180"         
          postbackvalue="Northern"
          alternatetext="Northern Region">
        </asp:PolygonHotSpot>
        
        <asp:PolygonHotSpot 
          coordinates="128,185,335,157,400,224,400,400,228,400"         
          postbackvalue="Southern"
          alternatetext="Southern Region">
        </asp:PolygonHotSpot>
      
      </asp:imagemap>
            
      <br /><br />
          
      <asp:label id="Message1"
        runat="Server">
      </asp:label>                 
                 
    </form>      
  </body>
</html>

Hinweise

Diese Klasse definiert einen polygonförmigen Hotspotbereich in einem ImageMap Steuerelement. Ist PolygonHotSpot nützlich, um unregelmäßig geformte Hot Spot-Bereiche in einem -Steuerelement zu ImageMap definieren. Sie können sie beispielsweise verwenden, um einzelne Regionen innerhalb einer geografischen Karte zu definieren.

Um den Bereich eines PolygonHotSpotzu definieren, legen Sie die Coordinates -Eigenschaft auf eine Zeichenfolge fest, die die Koordinaten jedes Scheitelpunkts des PolygonHotSpot Objekts angibt. Ein Polygonvertex ist ein Punkt, an dem zwei Polygonränder aufeinandertreffen.

Wenn auf ein PolygonHotSpot Objekt geklickt wird, navigiert die Seite zu einer URL, generiert einen Beitrag zurück zum Server oder macht nichts. Die HotSpotMode -Eigenschaft gibt dieses Verhalten an. Um zu einer URL zu navigieren, legen Sie die HotSpotMode -Eigenschaft auf HotSpotMode.Navigatefest, und verwenden Sie die NavigateUrl -Eigenschaft, um die URL anzugeben, zu der navigiert werden soll. Legen Sie HotSpotMode die -Eigenschaft auf HotSpotMode.PostBackfest, und verwenden Sie die PostBackValue -Eigenschaft, um einen Namen für das PolygonHotSpot -Objekt anzugeben. Dieser Name wird in den ImageMapEventArgs Ereignisdaten übergeben, wenn auf geklickt PolygonHotSpot wird. Wenn das PolygonHotSpot Objekt kein Verhalten aufweisen soll, legen Sie die HotSpotMode -Eigenschaft auf fest HotSpotMode.Inactive.

Konstruktoren

PolygonHotSpot()

Initialisiert eine neue Instanz der PolygonHotSpot-Klasse.

Eigenschaften

AccessKey	Ruft die Zugriffstaste ab, die die schnelle Navigation zum HotSpot-Bereich ermöglicht, oder legt diese fest. (Geerbt von HotSpot)
AlternateText	Ruft den alternativen Text für ein HotSpot-Objekt in einem ImageMap-Steuerelement ab, der angezeigt werden soll, wenn das Bild nicht verfügbar ist oder in einem Browser gerendert wird, der keine Bilder unterstützt, oder legt diesen fest. (Geerbt von HotSpot)
Coordinates	Eine Koordinatenzeichenfolge, die die Eckpunkte eines PolygonHotSpot-Objekts darstellt.
HotSpotMode	Gibt das Verhalten eines HotSpot-Objekts in einem ImageMap-Steuerelement beim Klicken auf den HotSpot an oder legt dieses fest. (Geerbt von HotSpot)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das HotSpot-Objekt die Änderungen des Ansichtszustands nachverfolgt. (Geerbt von HotSpot)
MarkupName	Ruft beim Überschreiben in einer abgeleiteten Klasse die Zeichenfolgendarstellung für die Form des HotSpot-Objekts ab. (Geerbt von HotSpot)
NavigateUrl	Ruft die URL ab, zu der beim Klicken auf ein HotSpot-Objekt navigiert wird, oder legt diese fest. (Geerbt von HotSpot)
PostBackValue	Ruft den Namen des HotSpot-Objekts ab, das beim Klicken auf den HotSpot in den Ereignisdaten übergeben werden soll, oder legt diesen fest. (Geerbt von HotSpot)
TabIndex	Ruft den Index der Aktivierreihenfolge des HotSpot-Bereichs ab oder legt diesen fest. (Geerbt von HotSpot)
Target	Ruft das Zielfenster oder den Zielframe ab, in dem der Inhalt der verknüpften Webseite dargestellt werden soll, wenn auf ein HotSpot-Objekt geklickt wird, das zu einer URL navigiert, oder legt diese fest. (Geerbt von HotSpot)
ViewState	Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines HotSpot-Objekts über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von HotSpot)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetCoordinates()	Gibt eine Zeichenfolge zurück, die die Koordinaten der Eckpunkte eines PolygonHotSpot-Objekts darstellt.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand des HotSpot-Objekts für das Objekt wieder her. (Geerbt von HotSpot)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
SaveViewState()	Speichert die Änderungen am Ansichtszustand des HotSpot-Objekts seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde. (Geerbt von HotSpot)
ToString()	Gibt die String-Darstellung dieser Instanz eines HotSpot-Objekts zurück. (Geerbt von HotSpot)
TrackViewState()	Bewirkt, dass das HotSpot-Objekt die Änderungen am Ansichtszustand nachverfolgt, sodass diese im StateBag-Objekt des Objekts gespeichert werden können. Auf dieses Objekt kann über die ViewState-Eigenschaft zugegriffen werden. (Geerbt von HotSpot)

Explizite Schnittstellenimplementierungen

IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das HotSpot-Objekt die Änderungen des Ansichtszustands nachverfolgt. (Geerbt von HotSpot)
IStateManager.LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand des HotSpot-Objekts für das Objekt wieder her. (Geerbt von HotSpot)
IStateManager.SaveViewState()	Speichert die Änderungen am Ansichtszustand des HotSpot-Objekts seit dem Zeitpunkt, zu dem die Seite das letzte Mal zurück an den Server gesendet wurde. (Geerbt von HotSpot)
IStateManager.TrackViewState()	Weist den HotSpot-Bereich an, Änderungen am Ansichtszustand nachzuverfolgen. (Geerbt von HotSpot)

Gilt für: