RectangleHotSpot Klasse

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

Das folgende Codebeispiel veranschaulicht das deklarative Erstellen eines ImageMap Steuerelements, das zwei RectangleHotSpot Objekte enthält. Die ImageMap.HotSpotMode Eigenschaft ist auf " HotSpotMode.PostBack, was bewirkt, dass die Seite bei jedem Klick auf einen der Hotspotbereiche wieder auf den Server zurückgesetzt wird. Jedes Mal, wenn der Benutzer auf eines der RectangleHotSpot Objekte klickt, wird die GetCoordinates Methode aufgerufen, und die Koordinaten des ausgewählten Hotspots werden dem Benutzer angezeigt. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie ihr eigenes Bild für die ImageUrl Eigenschaft angeben und den Pfad zum Bild 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 unteren rechten Ecke des rechteckigen Bereichs darstellt. Legen Sie die Bottom Eigenschaft auf den Wert fest, der die y-Koordinate der unteren rechten 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 führt nichts aus. Die HotSpotMode Eigenschaft gibt dieses Verhalten an. Um zu einer URL zu navigieren, legen Sie die HotSpotMode Eigenschaft auf HotSpotMode.Navigate die Eigenschaft fest, und verwenden Sie sie NavigateUrl , um die URL anzugeben, zu der navigiert werden soll. Legen Sie die HotSpotMode Eigenschaft auf HotSpotMode.PostBack den Server 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 auf sie RectangleHotSpot geklickt wird. . Wenn das HotSpot Objekt kein Verhalten aufweisen soll, legen Sie die HotSpotMode Eigenschaft auf HotSpotMode.Inactive.

Konstruktoren

Name	Beschreibung
RectangleHotSpot()	Initialisiert eine neue Instanz der RectangleHotSpot-Klasse.

Eigenschaften

Name	Beschreibung
AccessKey	Dient zum Abrufen oder Festlegen der Zugriffstaste, mit der Sie schnell zu der HotSpot Region navigieren können. (Geerbt von HotSpot)
AlternateText	Ruft den alternativen Text ab, der für ein HotSpot Objekt in einem ImageMap Steuerelement 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	Dient zum Abrufen oder Festlegen der y-Koordinate der unteren Seite des rechteckigen Bereichs, der durch dieses RectangleHotSpot Objekt definiert wird.
HotSpotMode	Ruft das Verhalten eines HotSpot Objekts in einem ImageMap Steuerelement ab, wenn auf das Objekt geklickt wird, oder legt dieses HotSpot fest. (Geerbt von HotSpot)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das HotSpot Objekt seine Ansichtszustandsänderungen nachverfolgt. (Geerbt von HotSpot)
Left	Ruft die x-Koordinate der linken Seite des rechteckigen Bereichs ab, der durch dieses RectangleHotSpot Objekt definiert wird, oder legt diese fest.
MarkupName	Beim Überschreiben in einer abgeleiteten Klasse ruft die Zeichenfolgendarstellung für die Form des HotSpot Objekts ab. (Geerbt von HotSpot)
NavigateUrl	Ruft die URL ab, zu der navigiert werden soll, wenn auf ein HotSpot Objekt geklickt wird, oder legt diese fest. (Geerbt von HotSpot)
PostBackValue	Ruft den Namen des Objekts ab, das HotSpot beim Klicken in die Ereignisdaten übergeben werden soll, oder legt diesen HotSpot fest. (Geerbt von HotSpot)
Right	Ruft die x-Koordinate der rechten Seite des rechteckigen Bereichs ab, der durch dieses RectangleHotSpot Objekt definiert wird, oder legt diese fest.
TabIndex	Dient zum Abrufen oder Festlegen des Registerkartenindex des HotSpot Bereichs. (Geerbt von HotSpot)
Target	Dient zum Abrufen oder Festlegen des Zielfensters oder Frames, in dem der Webseiteninhalt angezeigt werden soll, der verknüpft ist, wenn auf ein HotSpot Objekt, das zu einer URL navigiert, geklickt wird. (Geerbt von HotSpot)
Top	Ruft die y-Koordinate der oberen Seite des rechteckigen Bereichs ab, der durch dieses RectangleHotSpot Objekt definiert wird, oder legt diese fest.
ViewState	Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines HotSpot Objekts über mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von HotSpot)

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetCoordinates()	Gibt eine Zeichenfolge zurück, die die x--and y-Koordinaten der oberen linken Ecke eines RectangleHotSpot Objekts und die x- und y-Koordinaten der unteren rechten Ecke darstellt.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand des HotSpot Objekts wieder auf dem Objekt wieder her. (Geerbt von HotSpot)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
SaveViewState()	Speichert die Änderungen am Ansichtszustand des HotSpot Objekts seit dem Zeitpunkt, zu dem die Seite wieder auf dem Server gepostet 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 Änderungen am Ansichtszustand StateBag nachverfolgt, sodass sie im Objekt des Objekts gespeichert werden können. Auf dieses Objekt kann über die ViewState Eigenschaft zugegriffen werden. (Geerbt von HotSpot)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das HotSpot Objekt seine Ansichtszustandsänderungen nachverfolgt. (Geerbt von HotSpot)
IStateManager.LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand des HotSpot Objekts wieder auf dem Objekt wieder her. (Geerbt von HotSpot)
IStateManager.SaveViewState()	Speichert die Änderungen am Ansichtszustand des HotSpot Objekts seit dem letzten Veröffentlichen der Seite auf dem Server. (Geerbt von HotSpot)
IStateManager.TrackViewState()	Weist die HotSpot Region an, Änderungen am Ansichtszustand nachzuverfolgen. (Geerbt von HotSpot)

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?