RectangleHotSpot Klasse
Definition
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::HotSpotpublic sealed class RectangleHotSpot : System.Web.UI.WebControls.HotSpottype RectangleHotSpot = class
inherit HotSpotPublic NotInheritable Class RectangleHotSpot
Inherits HotSpot- Vererbung
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 geben Sie die NavigateUrl URL an, zu der sie navigieren 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) |
