RectangleHotSpot Klasa

Definicja

Namespace:: System.Web.UI.WebControls

Montaż:: System.Web.dll

Ważny

Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.

Definiuje prostokątny region miejsca gorącego w kontrolce ImageMap . Klasa ta nie może być dziedziczona.

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

Dziedziczenie: Object

HotSpot
RectangleHotSpot

Przykłady

W poniższym przykładzie kodu pokazano, jak deklaratywnie utworzyć kontrolkę zawierającą ImageMap dwa RectangleHotSpot obiekty. Właściwość ImageMap.HotSpotMode jest ustawiona na HotSpotMode.PostBackwartość , co powoduje, że strona będzie publikować z powrotem na serwerze za każdym razem, gdy użytkownik kliknie jeden z regionów gorącego miejsca. Za każdym razem, gdy użytkownik kliknie jeden z RectangleHotSpot obiektów, GetCoordinates metoda jest wywoływana, a współrzędne wybranego miejsca gorącego są wyświetlane użytkownikowi. Aby ten przykład działał poprawnie, należy 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 region miejsca gorącego w kontrolce ImageMap . Aby zdefiniować region RectangleHotSpot obiektu, ustaw Left właściwość na wartość reprezentującą współrzędną x w lewym górnym rogu regionu prostokątnego. Top Ustaw właściwość na wartość reprezentującą współrzędną y w lewym górnym rogu regionu prostokątnego. Right Ustaw właściwość na wartość reprezentującą współrzędną x prawego rogu prostokątnego regionu. Bottom Ustaw właściwość na wartość reprezentującą współrzędną y w prawym dolnym 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 wrócić do serwera, 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 w danych zdarzenia po kliknięciu ImageMapEventArgs RectangleHotSpot . . Jeśli chcesz HotSpot , aby obiekt nie miał żadnego zachowania, ustaw HotSpotMode właściwość na HotSpotMode.Inactive.

Konstruktorów

Nazwa	Opis
RectangleHotSpot()	Inicjuje nowe wystąpienie klasy RectangleHotSpot.

Właściwości

Nazwa	Opis
AccessKey	Pobiera lub ustawia klucz dostępu, który umożliwia szybkie przechodzenie do HotSpot regionu. (Dziedziczone od HotSpot)
AlternateText	Pobiera lub ustawia alternatywny tekst wyświetlany dla HotSpot obiektu w kontrolce ImageMap , gdy obraz jest niedostępny lub renderuje do przeglądarki, która nie obsługuje obrazów. (Dziedziczone od HotSpot)
Bottom	Pobiera lub ustawia współrzędną y u dołu prostokątnego regionu zdefiniowanego przez ten RectangleHotSpot obiekt.
HotSpotMode	Pobiera lub ustawia zachowanie HotSpot obiektu w kontrolce ImageMap po kliknięciu HotSpot . (Dziedziczone od HotSpot)
IsTrackingViewState	Pobiera wartość wskazującą, czy HotSpot obiekt śledzi zmiany stanu widoku. (Dziedziczone od HotSpot)
Left	Pobiera lub ustawia współrzędną x lewej strony prostokątnego regionu zdefiniowanego przez ten RectangleHotSpot obiekt.
MarkupName	Po zastąpieniu w klasie pochodnej pobiera reprezentację ciągu dla HotSpot kształtu obiektu. (Dziedziczone od HotSpot)
NavigateUrl	Pobiera lub ustawia adres URL, aby przejść do momentu HotSpot kliknięcia obiektu. (Dziedziczone od HotSpot)
PostBackValue	Pobiera lub ustawia nazwę HotSpot obiektu, który ma być przekazywany do danych zdarzenia po kliknięciu HotSpot . (Dziedziczone od HotSpot)
Right	Pobiera lub ustawia współrzędną x prawej strony prostokątnego regionu zdefiniowanego przez ten RectangleHotSpot obiekt.
TabIndex	Pobiera lub ustawia indeks tabulacji HotSpot regionu. (Dziedziczone od HotSpot)
Target	Pobiera lub ustawia okno docelowe lub ramkę, w której ma być wyświetlana zawartość strony sieci Web połączona po HotSpot kliknięciu obiektu, który przechodzi do adresu URL. (Dziedziczone od 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 zapisanie i przywrócenie stanu HotSpot widoku obiektu na wielu żądaniach dla tej samej strony. (Dziedziczone od HotSpot)

Metody

Nazwa	Opis
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Dziedziczone od Object)
GetCoordinates()	Zwraca ciąg reprezentujący współrzędne RectangleHotSpot x i y w lewym górnym rogu obiektu oraz współrzędne x i y w prawym dolnym rogu.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Dziedziczone od Object)
GetType()	Type Pobiera bieżące wystąpienie. (Dziedziczone od Object)
LoadViewState(Object)	HotSpot Przywraca wcześniej zapisany stan widoku obiektu do obiektu. (Dziedziczone od HotSpot)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object)
SaveViewState()	Zapisuje zmiany w HotSpot stanie widoku obiektu od czasu opublikowania strony z powrotem na serwerze. (Dziedziczone od HotSpot)
ToString()	Zwraca reprezentację String tego wystąpienia HotSpot obiektu. (Dziedziczone od HotSpot)
TrackViewState()	HotSpot Powoduje, że obiekt będzie śledzić zmiany w stanie widoku, aby można je było przechowywać w obiekcie obiektuStateBag. Ten obiekt jest dostępny za pośrednictwem ViewState właściwości . (Dziedziczone od HotSpot)

Implementacje interfejsów jawnych

Nazwa	Opis
IStateManager.IsTrackingViewState	Pobiera wartość wskazującą, czy HotSpot obiekt śledzi zmiany stanu widoku. (Dziedziczone od HotSpot)
IStateManager.LoadViewState(Object)	HotSpot Przywraca wcześniej zapisany stan widoku obiektu do obiektu. (Dziedziczone od HotSpot)
IStateManager.SaveViewState()	Zapisuje zmiany w HotSpot stanie widoku obiektu od czasu ostatniego opublikowania strony z powrotem na serwerze. (Dziedziczone od HotSpot)
IStateManager.TrackViewState()	Instruuje HotSpot region, aby śledzić zmiany w stanie widoku. (Dziedziczone od HotSpot)

Dotyczy

Zobacz także

Sprzężenie zwrotne

Czy ta strona była pomocna?