Nyelv

RectangleHotSpot Osztály

Definíció

Egy vezérlőelem négyszögletes, gyakori elérésű régióját ImageMap határozza meg. Ez az osztály nem örökölhető.

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
Öröklődés
RectangleHotSpot

Példák

Az alábbi példakód bemutatja, hogyan hozhat létre deklaratív módon két ImageMapRectangleHotSpot objektumot tartalmazó vezérlőt. A ImageMap.HotSpotMode tulajdonság értéke a következő, HotSpotMode.PostBackami miatt a lap minden alkalommal visszakerül a kiszolgálóra, amikor a felhasználó az egyik gyakori elérésű régióra kattint. Minden alkalommal, amikor a felhasználó az RectangleHotSpot egyik objektumra kattint, a rendszer meghívja a GetCoordinates metódust, és a kijelölt gyakori elérésű pont koordinátái megjelennek a felhasználó számára. Ahhoz, hogy ez a példa megfelelően működjön, meg kell adnia a ImageUrl tulajdonság saját rendszerképét, és megfelelően frissítenie kell a rendszerkép elérési útját, hogy az alkalmazás megtalálhassa.

<%@ 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>

Megjegyzések

Ez az osztály egy négyszögletes gyakori elérésű régiót határoz meg egy ImageMap vezérlőben. Az objektum régiójának RectangleHotSpot meghatározásához állítsa a Left tulajdonságot arra az értékre, amely a téglalap alakú régió bal felső sarkának x koordinátáját jelöli. Állítsa a Top tulajdonságot arra az értékre, amely a téglalap alakú régió bal felső sarkának y koordinátáját jelöli. Állítsa a Right tulajdonságot arra az értékre, amely a téglalap alakú régió jobb alsó sarkának x koordinátáját jelöli. A tulajdonság beállítása a Bottom téglalap alakú régió jobb alsó sarkának y koordinátáját jelölő értékre.

Ha egy RectangleHotSpot vezérlőre kattint, a lap egy URL-címre navigál, egy bejegyzést hoz létre vissza a kiszolgálóra, vagy nem tesz semmit. A HotSpotMode tulajdonság ezt a viselkedést határozza meg. Az URL-címre való navigáláshoz állítsa be a HotSpotMode tulajdonságot HotSpotMode.Navigate , és használja a NavigateUrl tulajdonságot a navigáláshoz használt URL-cím megadásához. A kiszolgálóra való visszatéréshez állítsa be a HotSpotMode tulajdonságot HotSpotMode.PostBack , és használja a PostBackValue tulajdonságot az RectangleHotSpot objektum nevének megadásához. Ez a név az eseményadatokban ImageMapEventArgs lesz átadva, amikor a RectangleHotSpot rendszer rákattint. . Ha azt szeretné, hogy az HotSpot objektumnak ne legyen viselkedése, állítsa a tulajdonságot a HotSpotMode következőre HotSpotMode.Inactive: .

Konstruktorok

Név Description
RectangleHotSpot()

Inicializálja a RectangleHotSpot osztály új példányát.

Tulajdonságok

Név Description
AccessKey

Lekéri vagy beállítja a hozzáférési kulcsot, amely lehetővé teszi a régió gyors navigálását HotSpot .

(Öröklődés forrása HotSpot)
AlternateText

Lekéri vagy beállítja a helyettesítő szöveget egy HotSpot vezérlő objektumához ImageMap , ha a kép nem érhető el, vagy olyan böngészőben jeleníti meg, amely nem támogatja a képeket.

(Öröklődés forrása HotSpot)
Bottom

Lekéri vagy beállítja az objektum által RectangleHotSpot definiált négyszögletes terület alsó oldalának y koordinátáját.

HotSpotMode

Lekéri vagy beállítja egy HotSpot objektum viselkedését egy ImageMap vezérlőelemben, amikor a HotSpot rendszer rákattint.

(Öröklődés forrása HotSpot)
IsTrackingViewState

Beolvas egy értéket, amely jelzi, hogy az HotSpot objektum nyomon követi-e a nézetállapot változásait.

(Öröklődés forrása HotSpot)
Left

Lekéri vagy beállítja az objektum által RectangleHotSpot definiált négyszögletes terület bal oldalának x koordinátáját.

MarkupName

Ha felül van bírálva egy származtatott osztályban, lekéri az HotSpot objektum alakzatának sztringképét.

(Öröklődés forrása HotSpot)
NavigateUrl

Lekéri vagy beállítja az URL-címet, hogy az objektumra kattintáskor HotSpot navigáljon.

(Öröklődés forrása HotSpot)
PostBackValue

Lekéri vagy beállítja annak az objektumnak a HotSpot nevét, amelyet a rendszer a kattintáskor továbbít az HotSpot eseményadatokban.

(Öröklődés forrása HotSpot)
Right

Lekéri vagy beállítja az objektum által RectangleHotSpot definiált négyszögletes terület jobb oldalának x koordinátáját.

TabIndex

Lekéri vagy beállítja a régió tabulátorindexét HotSpot .

(Öröklődés forrása HotSpot)
Target

Lekéri vagy beállítja azt a célablakot vagy keretet, amelyben megjelenítheti az URL-címre navigáló objektumhoz csatolt HotSpot weblaptartalmat.

(Öröklődés forrása HotSpot)
Top

Lekéri vagy beállítja az objektum által RectangleHotSpot definiált négyszögletes terület felső részének y koordinátáját.

ViewState

Lekéri az állapotinformációk szótárát, amely lehetővé teszi egy objektum nézetállapotának mentését és visszaállítását HotSpot ugyanazon lap több kérésében.

(Öröklődés forrása HotSpot)

Metódusok

Név Description
Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
GetCoordinates()

Olyan sztringet ad vissza, amely egy RectangleHotSpot objektum bal felső sarkának x -and y koordinátáit, valamint a jobb alsó sarok x és y koordinátáit jelöli.

GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
LoadViewState(Object)

Visszaállítja az HotSpot objektum korábban mentett nézetállapotát az objektumra.

(Öröklődés forrása HotSpot)
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
SaveViewState()

Menti az HotSpot objektum nézetállapotának módosításait a lap kiszolgálóra való visszatérése óta.

(Öröklődés forrása HotSpot)
ToString()

String Egy objektum jelen példányának ábrázolását HotSpot adja vissza.

(Öröklődés forrása HotSpot)
TrackViewState()

HotSpot Az objektum nyomon követi a nézetállapot változásait, hogy azok az objektum StateBag objektumában tárolhatók legyenek. Ez az objektum a ViewState tulajdonságon keresztül érhető el.

(Öröklődés forrása HotSpot)

Explicit interfész-implementációk

Név Description
IStateManager.IsTrackingViewState

Beolvas egy értéket, amely jelzi, hogy az HotSpot objektum nyomon követi-e a nézetállapot változásait.

(Öröklődés forrása HotSpot)
IStateManager.LoadViewState(Object)

Visszaállítja az HotSpot objektum korábban mentett nézetállapotát az objektumra.

(Öröklődés forrása HotSpot)
IStateManager.SaveViewState()

Menti az HotSpot objektum nézetállapotának módosításait az utolsó alkalommal, amikor a lap visszakerült a kiszolgálóra.

(Öröklődés forrása HotSpot)
IStateManager.TrackViewState()

Utasítja a HotSpot régiót, hogy kövesse nyomon a nézetállapot változásait.

(Öröklődés forrása HotSpot)

A következőre érvényes:

Lásd még