PolygonHotSpot PolygonHotSpot PolygonHotSpot PolygonHotSpot Class

Definition

Definiert einen polygonförmigen Hotspotbereich in einem ImageMap-Steuerelement.Defines a polygon-shaped hot spot region in an ImageMap control. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

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
PolygonHotSpotPolygonHotSpotPolygonHotSpotPolygonHotSpot

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein ImageMap -Steuerelement erstellt PolygonHotSpot wird, das drei-Objekte enthält.The following code example demonstrates how to create an ImageMap control that contains three PolygonHotSpot objects. Jedes PolygonHotSpot -Objekt stellt einen geografischen Bereich auf der Karte dar.Each PolygonHotSpot object represents a geographical region on the map. Wenn der Benutzer auf ein PolygonHotSpot -Objekt klickt, wird er an den Server zurückgesendet, und der Typ und der Name des Hotspots werden in einer Bezeichnung angezeigt.When the user clicks a PolygonHotSpot object, it posts back to the server and the type and name of the hot spot are displayed in a label.

<%@ 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 Polygon förmigen Hotspot Bereich in einem ImageMap -Steuerelement.This class defines a polygon-shaped hot spot region in an ImageMap control. Der PolygonHotSpot eignet sich zum Definieren von unregelmäßig formatierte Hot-Spot- ImageMap Bereiche in einem-Steuerelement.The PolygonHotSpot is useful for defining irregularly shaped hot spot regions in an ImageMap control. Beispielsweise können Sie damit einzelne Bereiche innerhalb einer geografischen Karte definieren.For example, you can use it to define individual regions within a geographical map.

Wenn Sie den Bereich eines PolygonHotSpotdefinieren möchten, legen Sie die Coordinates -Eigenschaft auf eine Zeichenfolge fest, die die Koordinaten der PolygonHotSpot einzelnen Scheitel Punkte des Objekts angibt.To define the region of a PolygonHotSpot, set the Coordinates property to a string that specifies the coordinates of each vertex of the PolygonHotSpot object. Ein Polygon Scheitelpunkt ist ein Punkt, an dem zwei Polygon Ränder entsprechen.A polygon vertex is a point at which two polygon edges meet.

Wenn auf PolygonHotSpot ein-Objekt geklickt wird, navigiert die Seite zu einer URL, generiert ein Postback an den Server oder führt keine Aktion aus.When a PolygonHotSpot object is clicked, the page navigates to a URL, generates a post back to the server, or does nothing. Die HotSpotMode -Eigenschaft gibt dieses Verhalten an.The HotSpotMode property specifies this behavior. Um zu einer URL zu navigieren, legen HotSpotMode Sie die HotSpotMode.Navigate-Eigenschaft auf fest NavigateUrl und verwenden die-Eigenschaft, um die URL anzugeben, zu der navigiert werden soll.To navigate to a URL, set the HotSpotMode property to HotSpotMode.Navigate, and use the NavigateUrl property to specify the URL to navigate to. Legen Sie zum Postback an den Server die HotSpotMode -Eigenschaft HotSpotMode.PostBackauf fest, und PostBackValue verwenden Sie die-Eigenschaft, um PolygonHotSpot einen Namen für das-Objekt anzugeben.To post back to the server, set the HotSpotMode property to HotSpotMode.PostBack, and use the PostBackValue property to specify a name for the PolygonHotSpot object. Dieser Name wird in den ImageMapEventArgs Ereignisdaten angezeigt, wenn auf das PolygonHotSpot geklickt wird.This name will be passed in the ImageMapEventArgs event data when the PolygonHotSpot is clicked. Wenn das PolygonHotSpot -Objekt kein Verhalten aufweisen soll, legen Sie die HotSpotMode -Eigenschaft HotSpotMode.Inactiveauf fest.If you want the PolygonHotSpot object to have no behavior, set the HotSpotMode property to HotSpotMode.Inactive.

Konstruktoren

PolygonHotSpot() PolygonHotSpot() PolygonHotSpot() PolygonHotSpot()

Initialisiert eine neue Instanz der PolygonHotSpot-Klasse.Initializes a new instance of the PolygonHotSpot class.

Eigenschaften

AccessKey AccessKey AccessKey AccessKey

Ruft die Zugriffstaste ab, die die schnelle Navigation zum HotSpot-Bereich ermöglicht, oder legt diese fest.Gets or sets the access key that allows you to quickly navigate to the HotSpot region.

(Inherited from HotSpot)
AlternateText AlternateText AlternateText 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.Gets or sets the alternate text to display for a HotSpot object in an ImageMap control when the image is unavailable or renders to a browser that does not support images.

(Inherited from HotSpot)
Coordinates Coordinates Coordinates Coordinates

Eine Koordinatenzeichenfolge, die die Eckpunkte eines PolygonHotSpot-Objekts darstellt.A string of coordinates that represents the vertexes of a PolygonHotSpot object.

HotSpotMode HotSpotMode HotSpotMode HotSpotMode

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.

(Inherited from HotSpot)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das HotSpot-Objekt die Änderungen des Ansichtszustands nachverfolgt.Gets a value indicating whether the HotSpot object is tracking its view-state changes.

(Inherited from HotSpot)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das HotSpot-Objekt die Änderungen des Ansichtszustands nachverfolgt.Gets a value indicating whether the HotSpot object is tracking its view-state changes.

(Inherited from HotSpot)
MarkupName MarkupName MarkupName MarkupName

Ruft beim Überschreiben in einer abgeleiteten Klasse die Zeichenfolgendarstellung für die Form des HotSpot-Objekts ab.When overridden in a derived class, gets the string representation for the HotSpot object's shape.

(Inherited from HotSpot)
NavigateUrl NavigateUrl NavigateUrl NavigateUrl

Ruft die URL ab, zu der beim Klicken auf ein HotSpot-Objekt navigiert wird, oder legt diese fest.Gets or sets the URL to navigate to when a HotSpot object is clicked.

(Inherited from HotSpot)
PostBackValue PostBackValue PostBackValue PostBackValue

Ruft den Namen des HotSpot-Objekts ab, das beim Klicken auf den HotSpot in den Ereignisdaten übergeben werden soll, oder legt diesen fest.Gets or sets the name of the HotSpot object to pass in the event data when the HotSpot is clicked.

(Inherited from HotSpot)
TabIndex TabIndex TabIndex TabIndex

Ruft den Index der Aktivierreihenfolge des HotSpot-Bereichs ab oder legt diesen fest.Gets or sets the tab index of the HotSpot region.

(Inherited from HotSpot)
Target Target Target 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.Gets or sets the target window or frame in which to display the Web page content linked to when a HotSpot object that navigates to a URL is clicked.

(Inherited from HotSpot)
ViewState ViewState ViewState 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.Gets a dictionary of state information that allows you to save and restore the view state of a HotSpot object across multiple requests for the same page.

(Inherited from HotSpot)

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetCoordinates() GetCoordinates() GetCoordinates() GetCoordinates()

Gibt eine Zeichenfolge zurück, die die Koordinaten der Eckpunkte eines PolygonHotSpot-Objekts darstellt.Returns a string that represents the coordinates of the vertexes of a PolygonHotSpot object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Stellt den zuvor gespeicherten Ansichtszustand des HotSpot-Objekts für das Objekt wieder her.Restores the HotSpot object's previously saved view state to the object.

(Inherited from HotSpot)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Speichert die Änderungen am Ansichtszustand des HotSpot-Objekts seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde.Saves the changes to the HotSpot object's view state since the time the page was posted back to the server.

(Inherited from HotSpot)
ToString() ToString() ToString() ToString()

Gibt die String-Darstellung dieser Instanz eines HotSpot-Objekts zurück.Returns the String representation of this instance of a HotSpot object.

(Inherited from HotSpot)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Bewirkt, dass das HotSpot-Objekt die Änderungen am Ansichtszustand nachverfolgt, sodass diese im StateBag-Objekt des Objekts gespeichert werden können.Causes the HotSpot object to track changes to its view state so they can be stored in the object's StateBag object. Auf dieses Objekt kann über die ViewState-Eigenschaft zugegriffen werden.This object is accessible through the ViewState property.

(Inherited from HotSpot)

Explizite Schnittstellenimplementierungen

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Stellt den zuvor gespeicherten Ansichtszustand des HotSpot-Objekts für das Objekt wieder her.Restores the HotSpot object's previously saved view state to the object.

(Inherited from HotSpot)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() 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.Saves the changes to the HotSpot object's view state since the last time the page was posted back to the server.

(Inherited from HotSpot)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Weist den HotSpot-Bereich an, Änderungen am Ansichtszustand nachzuverfolgen.Instructs the HotSpot region to track changes to its view state.

(Inherited from HotSpot)

Gilt für:

Siehe auch