RectangleHotSpot Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Definiuje prostokątny obszar punktów dostępu w kontrolce ImageMap . Klasa ta nie może być dziedziczona.
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- Dziedziczenie
Przykłady
W poniższym przykładzie kodu pokazano, jak deklaratywnie utworzyć kontrolkę zawierającą ImageMap dwa RectangleHotSpot obiekty. Właściwość jest ustawiona ImageMap.HotSpotMode na HotSpotMode.PostBack, co powoduje, że strona jest publikowana z powrotem na serwerze za każdym razem, gdy użytkownik kliknie jeden z regionów hot spot. Za każdym razem, gdy użytkownik kliknie jeden z RectangleHotSpot obiektów, GetCoordinates wywoływana jest metoda , a współrzędne wybranego punktu gorącego są wyświetlane użytkownikowi. Aby ten przykład działał poprawnie, musisz podać własny obraz dla ImageUrl właściwości i odpowiednio zaktualizować ścieżkę do obrazu, aby aplikacja mogła ją zlokalizować.
<%@ 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>
Uwagi
Ta klasa definiuje prostokątny obszar punktów dostępu w kontrolce ImageMap . Aby zdefiniować region RectangleHotSpot obiektu, ustaw Left właściwość na wartość reprezentującą współrzędną x lewego górnego rogu regionu prostokątnego. Top Ustaw właściwość na wartość reprezentującą współrzędną y w lewym górnym rogu prostokątnego regionu. Right Ustaw właściwość na wartość reprezentującą współrzędną x prawego dolnego rogu prostokątnego regionu. Bottom Ustaw właściwość na wartość reprezentującą współrzędną y prawego dolnego rogu prostokątnego regionu.
Po kliknięciu RectangleHotSpot kontrolki strona przechodzi do adresu URL, generuje wpis z powrotem na serwerze lub nic nie robi. Właściwość HotSpotMode określa to zachowanie. Aby przejść do adresu URL, ustaw HotSpotMode właściwość na HotSpotMode.Navigate i użyj NavigateUrl właściwości , aby określić adres URL do przejścia. Aby opublikować obiekt z powrotem na serwerze, ustaw HotSpotMode właściwość na HotSpotMode.PostBack i użyj PostBackValue właściwości , aby określić nazwę RectangleHotSpot obiektu. Ta nazwa zostanie przekazana ImageMapEventArgs w danych zdarzenia po kliknięciu RectangleHotSpot . . Jeśli chcesz HotSpot , aby obiekt nie miał żadnego zachowania, ustaw HotSpotMode właściwość na HotSpotMode.Inactive.
Konstruktory
| RectangleHotSpot() |
Inicjuje nowe wystąpienie klasy RectangleHotSpot. |
Właściwości
| AccessKey |
Pobiera lub ustawia klucz dostępu, który umożliwia szybkie przejście do HotSpot regionu. (Odziedziczone po HotSpot) |
| AlternateText |
Pobiera lub ustawia alternatywny tekst do wyświetlenia dla obiektu w kontrolce, gdy obraz jest niedostępny lub renderowany w przeglądarce, HotSpot ImageMap która nie obsługuje obrazów. (Odziedziczone po HotSpot) |
| Bottom |
Pobiera lub ustawia współrzędną y dolnej części prostokątnego regionu zdefiniowanego przez ten RectangleHotSpot obiekt. |
| HotSpotMode |
Pobiera lub ustawia zachowanie obiektu HotSpot w ImageMap kontrolce po HotSpot kliknięciu. (Odziedziczone po HotSpot) |
| IsTrackingViewState |
Pobiera wartość wskazującą, czy HotSpot obiekt śledzi zmiany stanu widoku. (Odziedziczone po HotSpot) |
| Left |
Pobiera lub ustawia współrzędną x lewej strony prostokątnego regionu zdefiniowanego przez ten RectangleHotSpot obiekt. |
| MarkupName |
W przypadku przesłonięć w klasie pochodnej pobiera reprezentację ciągu HotSpot dla kształtu obiektu. (Odziedziczone po HotSpot) |
| NavigateUrl |
Pobiera lub ustawia adres URL, do którym ma nawigować po HotSpot kliknięciu obiektu. (Odziedziczone po HotSpot) |
| PostBackValue |
Pobiera lub ustawia nazwę obiektu HotSpot do przekazania danych zdarzenia po HotSpot kliknięciu. (Odziedziczone po HotSpot) |
| Right |
Pobiera lub ustawia współrzędną x prawej strony prostokątnego regionu zdefiniowanego przez ten RectangleHotSpot obiekt. |
| TabIndex |
Pobiera lub ustawia indeks karty HotSpot regionu. (Odziedziczone po HotSpot) |
| Target |
Pobiera lub ustawia okno docelowe lub ramkę, w której ma być wyświetlana zawartość strony internetowej, z którą jest połączona po kliknięciu obiektu, który przechodzi HotSpot do adresu URL. (Odziedziczone po HotSpot) |
| Top |
Pobiera lub ustawia współrzędną y górnej części prostokątnego regionu zdefiniowanego przez ten RectangleHotSpot obiekt. |
| ViewState |
Pobiera słownik informacji o stanie, który umożliwia zapisywanie i przywracanie stanu widoku obiektu w wielu HotSpot żądaniach dla tej samej strony. (Odziedziczone po HotSpot) |
Metody
| Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
| GetCoordinates() |
Zwraca ciąg reprezentujący współrzędne RectangleHotSpot x i y lewego górnego rogu obiektu oraz współrzędne x i y w prawym dolnym rogu. |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
| LoadViewState(Object) |
Przywraca wcześniej zapisany stan widoku obiektu HotSpot do obiektu. (Odziedziczone po HotSpot) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| SaveViewState() |
Zapisuje zmiany stanu widoku obiektu od HotSpot czasu, gdy strona została opublikowana z powrotem na serwerze. (Odziedziczone po HotSpot) |
| ToString() |
Zwraca String reprezentację tego wystąpienia HotSpot obiektu. (Odziedziczone po HotSpot) |
| TrackViewState() |
Powoduje, że obiekt ma śledzić zmiany stanu widoku, dzięki czemu HotSpot mogą być przechowywane w obiekcie StateBag obiektu. Ten obiekt jest dostępny za pośrednictwem ViewState właściwości . (Odziedziczone po HotSpot) |
Jawne implementacje interfejsu
| IStateManager.IsTrackingViewState |
Pobiera wartość wskazującą, czy HotSpot obiekt śledzi zmiany stanu widoku. (Odziedziczone po HotSpot) |
| IStateManager.LoadViewState(Object) |
Przywraca wcześniej zapisany stan widoku HotSpot obiektu do obiektu. (Odziedziczone po HotSpot) |
| IStateManager.SaveViewState() |
Zapisuje zmiany stanu widoku obiektu od czasu ostatniego wpisu strony na HotSpot serwerze. (Odziedziczone po HotSpot) |
| IStateManager.TrackViewState() |
Instruuje HotSpot region, aby śledził zmiany stanu widoku. (Odziedziczone po HotSpot) |