RectangleHotSpot 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 rechteckigen Hotspotbereich in einem ImageMap-Steuerelement. Diese Klasse kann nicht vererbt werden.

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

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

type RectangleHotSpot = class
    inherit HotSpot

Public NotInheritable Class RectangleHotSpot
Inherits HotSpot

Vererbung: Object

HotSpot
RectangleHotSpot

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein ImageMap Steuerelement deklarativ erstellt wird, das zwei RectangleHotSpot Objekte enthält. Die ImageMap.HotSpotMode -Eigenschaft ist auf HotSpotMode.PostBackfestgelegt, wodurch die Seite jedes Mal, wenn ein Benutzer auf eine der Hotspotregionen klickt, auf den Server zurückgibt. Jedes Mal, wenn der Benutzer auf eines der RectangleHotSpot Objekte klickt, wird die GetCoordinates -Methode aufgerufen, und dem Benutzer werden die Koordinaten des ausgewählten Hotspots angezeigt. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie Ihr eigenes Image für die ImageUrl -Eigenschaft angeben und den Pfad zum Image entsprechend aktualisieren, damit die Anwendung es finden 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)
  {
    string coordinates;
    string hotSpotType;
    int yescount = ((ViewState["yescount"] != null)? (int)ViewState["yescount"] : 0);
    int nocount = ((ViewState["nocount"] != null)? (int)ViewState["nocount"] : 0);

    // When a user clicks the "Yes" hot spot,
    // display the hot spot's name and coordinates.
    if (e.PostBackValue.Contains("Yes"))
    {
      yescount += 1;
      coordinates = Vote.HotSpots[0].GetCoordinates();
      hotSpotType = Vote.HotSpots[0].ToString ();
      Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue + ".<br />" +
                      "The coordinates are " + coordinates + ".<br />" +
                      "The current vote count is " + yescount.ToString() + 
            " yes votes and " + nocount.ToString() + " no votes.";
    }
      
    // When a user clicks the "No" hot spot,
    // display the hot spot's name and coordinates.
    else if (e.PostBackValue.Contains("No"))
    {
      nocount += 1;
      coordinates = Vote.HotSpots[1].GetCoordinates();
      hotSpotType = Vote.HotSpots[1].ToString ();
      Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue + ".<br />" +
                      "The coordinates are " + coordinates + ".<br />" +
            "The current vote count is " + yescount.ToString() +
            " yes votes and " + nocount.ToString() + " no votes.";
    }
    
    else
    {
      Message1.Text = "You did not click a valid hot spot region.";
    }

    ViewState["yescount"] = yescount;
    ViewState["nocount"] = nocount;
  }           
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap Class Post Back Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap Class Post Back Example</h3>
      
      <asp:imagemap id="Vote"           
        imageurl="Images/VoteImage.jpg"
        width="400" 
        height="200" 
        alternatetext="Vote Yes or No"
        hotspotmode="PostBack"
        onclick="VoteMap_Clicked"
        runat="Server">            
          
        <asp:RectangleHotSpot          
          top="0"
          left="0"
          bottom="200"
          right="200"
          postbackvalue="Yes"
          alternatetext="Vote yes">
        </asp:RectangleHotSpot>
          
        <asp:RectangleHotSpot 
          top="0"
          left="201"
          bottom="200"
          right="400"
          postbackvalue="No"
          alternatetext="Vote no">
        </asp:RectangleHotSpot>
      
      </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 VoteMap_Clicked(ByVal sender As Object, ByVal e As ImageMapEventArgs)
    Dim coordinates As String
    Dim hotSpotType As String
    Dim yescount As Integer
    Dim nocount As Integer
    
    If (ViewState("yescount") IsNot Nothing) Then
      yescount = Convert.ToInt32(ViewState("yescount"))
    Else
      yescount = 0
    End If
    If (ViewState("nocount") IsNot Nothing) Then
      nocount = Convert.ToInt32(ViewState("nocount"))
    Else
      nocount = 0
    End If
      
    
    ' When a user clicks the "Yes" hot spot,
    ' display the hot spot's name and coordinates.
    If (e.PostBackValue.Contains("Yes")) Then
      
      yescount += 1
      coordinates = Vote.HotSpots(0).GetCoordinates()
      hotSpotType = Vote.HotSpots(0).ToString()
      Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue & ".<br />" & _
                      "The coordinates are " & coordinates & ".<br />" & _
                      "The current vote count is " & yescount.ToString() & _
                      " yes votes and " & nocount.ToString() & " no votes."
       
      ' When a user clicks the "No" hot spot,
      ' display the hot spot's name and coordinates.
    ElseIf (e.PostBackValue.Contains("No")) Then
      
      nocount += 1
      coordinates = Vote.HotSpots.Item(1).GetCoordinates()
      hotSpotType = Vote.HotSpots.Item(1).ToString()
      Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue & ".<br />" & _
                     "The coordinates are " & coordinates & ".<br />" & _
                      "The current vote count is " & yescount.ToString() & _
                      " yes votes and " & nocount.ToString() & " no votes."
      
    Else
      
      Message1.Text = "You did not click a valid hot spot region."
                
    End If
      
    ViewState("yescount") = yescount
    ViewState("nocount") = nocount
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
  <title>ImageMap Class Post Back Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    
      <h3>ImageMap Class Post Back Example</h3>
      
      <asp:imagemap id="Vote"           
        imageurl="Images/VoteImage.jpg"
        width="400" 
        height="200" 
        alternatetext="Vote Yes or No"
        hotspotmode="PostBack"
        onclick="VoteMap_Clicked"
        runat="Server">            
          
        <asp:RectangleHotSpot          
          top="0"
          left="0"
          bottom="200"
          right="200"
          postbackvalue="Yes"
          alternatetext="Vote yes">
        </asp:RectangleHotSpot>
          
        <asp:RectangleHotSpot 
          top="0"
          left="201"
          bottom="200"
          right="400"
          postbackvalue="No"
          alternatetext="Vote no">
        </asp:RectangleHotSpot>
      
      </asp:imagemap>
            
      <br /><br />
          
      <asp:label id="Message1"
        runat="Server">
      </asp:label>                 
                 
    </form>      
  </body>
</html>

Hinweise

Diese Klasse definiert einen rechteckigen Hotspotbereich in einem ImageMap Steuerelement. Um den Bereich des RectangleHotSpot Objekts zu definieren, legen Sie die Left -Eigenschaft auf den Wert fest, der die x-Koordinate der oberen linken Ecke des rechteckigen Bereichs darstellt. Legen Sie die Top -Eigenschaft auf den Wert fest, der die y-Koordinate der oberen linken Ecke des rechteckigen Bereichs darstellt. Legen Sie die Right -Eigenschaft auf den Wert fest, der die x-Koordinate der rechten unteren Ecke des rechteckigen Bereichs darstellt. Legen Sie die Bottom -Eigenschaft auf den Wert fest, der die y-Koordinate der rechten unteren Ecke des rechteckigen Bereichs darstellt.

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

Konstruktoren

RectangleHotSpot()

Initialisiert eine neue Instanz der RectangleHotSpot-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)
Bottom	Ruft die y-Koordinate des unteren Randes des rechteckigen Bereichs ab, der durch dieses RectangleHotSpot-Objekt definiert ist, oder legt sie fest.
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)
Left	Ruft die x-Koordinate des linken Randes des rechteckigen Bereichs ab, der durch dieses RectangleHotSpot-Objekt definiert ist, oder legt sie fest.
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)
Right	Ruft die x-Koordinate des rechten Randes des rechteckigen Bereichs ab, der durch dieses RectangleHotSpot-Objekt definiert ist, oder legt sie fest.
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)
Top	Ruft die y-Koordinate des oberen Randes des rechteckigen Bereichs ab, der durch dieses RectangleHotSpot-Objekt definiert ist, oder legt sie fest.
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 x- und y-Koordinaten der linken oberen Ecke und die x- und y-Koordinaten der rechten unteren Ecke eines RectangleHotSpot-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: