RectangleHotSpot Classe

Definizione

Definisce un'area sensibile rettangolare in un controllo ImageMap. La classe non può essere ereditata.

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
Ereditarietà
RectangleHotSpot

Esempio

Nell'esempio di codice seguente viene illustrato come creare in modo dichiarativo un ImageMap controllo contenente due RectangleHotSpot oggetti. La ImageMap.HotSpotMode proprietà è impostata su HotSpotMode.PostBack, che causa il postback della pagina al server ogni volta che un utente fa clic su una delle aree di accesso frequente. Ogni volta che l'utente fa clic su uno degli RectangleHotSpot oggetti, il GetCoordinates metodo viene chiamato e le coordinate dell'area di scelta rapida selezionata vengono visualizzate all'utente. Per il corretto funzionamento di questo esempio, è necessario specificare la propria immagine per la ImageUrl proprietà e aggiornare il percorso dell'immagine in modo appropriato in modo che l'applicazione possa individuarla.

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

Commenti

Questa classe definisce un'area a caldo rettangolare in un ImageMap controllo. Per definire l'area dell'oggetto RectangleHotSpot , impostare la Left proprietà sul valore che rappresenta la coordinata x dell'angolo superiore sinistro dell'area rettangolare. Impostare la Top proprietà sul valore che rappresenta la coordinata y dell'angolo superiore sinistro dell'area rettangolare. Impostare la Right proprietà sul valore che rappresenta la coordinata x dell'angolo inferiore destro dell'area rettangolare. Impostare la Bottom proprietà sul valore che rappresenta la coordinata y dell'angolo inferiore destro dell'area rettangolare.

Quando viene fatto clic su un RectangleHotSpot controllo, la pagina passa a un URL, genera un post indietro al server o non esegue alcuna operazione. La HotSpotMode proprietà specifica questo comportamento. Per passare a un URL, impostare la proprietà su HotSpotMode.Navigate e usare la NavigateUrlHotSpotMode proprietà per specificare l'URL da passare a. Per eseguire il postback al server, impostare la proprietà su e usare la HotSpotModePostBackValue proprietà per specificare un nome per l'oggettoRectangleHotSpot.HotSpotMode.PostBack Questo nome verrà passato nei dati dell'evento ImageMapEventArgs quando viene RectangleHotSpot fatto clic. . Se si vuole che l'oggetto HotSpot non abbia alcun comportamento, impostare la HotSpotMode proprietà su HotSpotMode.Inactive.

Costruttori

RectangleHotSpot()

Inizializza una nuova istanza della classe RectangleHotSpot.

Proprietà

AccessKey

Ottiene o imposta il tasto di scelta che consente di spostarsi rapidamente sull'area HotSpot.

(Ereditato da HotSpot)
AlternateText

Ottiene o imposta il testo alternativo da visualizzare per un oggetto HotSpot in un controllo ImageMap se l'immagine non è disponibile o il rendering viene eseguito su un browser che non supporta le immagini.

(Ereditato da HotSpot)
Bottom

Ottiene o imposta la coordinata y del lato inferiore dell'area rettangolare definita da questo oggetto RectangleHotSpot.

HotSpotMode

Ottiene o imposta il comportamento di un oggetto HotSpot in un controllo ImageMap quando viene fatto clic su HotSpot.

(Ereditato da HotSpot)
IsTrackingViewState

Ottiene un valore che indica se l'oggetto HotSpot tiene traccia delle modifiche apportate al relativo stato di visualizzazione.

(Ereditato da HotSpot)
Left

Ottiene o imposta la coordinata x del lato sinistro dell'area rettangolare definita da questo oggetto RectangleHotSpot.

MarkupName

Quando viene sottoposto a override in una classe derivata, ottiene la rappresentazione in formato stringa della forma dell'oggetto HotSpot.

(Ereditato da HotSpot)
NavigateUrl

Ottiene o imposta l'URL a cui passare quando viene fatto clic su un oggetto HotSpot.

(Ereditato da HotSpot)
PostBackValue

Ottiene o imposta il nome dell'oggetto HotSpot da passare nei dati dell'evento quando viene fatto clic su HotSpot.

(Ereditato da HotSpot)
Right

Ottiene o imposta la coordinata x del lato destro dell'area rettangolare definita da questo oggetto RectangleHotSpot.

TabIndex

Ottiene o imposta l'indice di tabulazione dell'area HotSpot.

(Ereditato da HotSpot)
Target

Ottiene o imposta la finestra o il frame di destinazione in cui visualizzare il contenuto della pagina Web collegato quando viene fatto clic su un oggetto HotSpot che esegue lo spostamento su un URL.

(Ereditato da HotSpot)
Top

Ottiene o imposta la coordinata y del lato superiore dell'area rettangolare definita da questo oggetto RectangleHotSpot.

ViewState

Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un oggetto HotSpot tra più richieste per la stessa pagina.

(Ereditato da HotSpot)

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetCoordinates()

Restituisce una stringa che rappresenta le coordinate x e y dell'angolo superiore sinistro e dell'angolo inferiore destro di un oggetto RectangleHotSpot.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
LoadViewState(Object)

Ripristina lo stato di visualizzazione precedentemente salvato dell'oggetto HotSpot.

(Ereditato da HotSpot)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione dell'oggetto HotSpot dal momento in cui è stato eseguito il postback della pagina al server.

(Ereditato da HotSpot)
ToString()

Restituisce la rappresentazione String di questa istanza di un oggetto HotSpot.

(Ereditato da HotSpot)
TrackViewState()

Fa in modo che l'oggetto HotSpot tenga traccia delle modifiche apportate allo stato di visualizzazione affinché vengano archiviate nell'oggetto StateBag dell'oggetto. È possibile accedere a questo oggetto tramite la proprietà ViewState.

(Ereditato da HotSpot)

Implementazioni dell'interfaccia esplicita

IStateManager.IsTrackingViewState

Ottiene un valore che indica se l'oggetto HotSpot tiene traccia delle modifiche apportate al relativo stato di visualizzazione.

(Ereditato da HotSpot)
IStateManager.LoadViewState(Object)

Ripristina lo stato di visualizzazione precedentemente salvato dell'oggetto HotSpot.

(Ereditato da HotSpot)
IStateManager.SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione dell'oggetto HotSpot dall'ultimo postback della pagina al server.

(Ereditato da HotSpot)
IStateManager.TrackViewState()

Indica all'area HotSpot di tenere traccia delle modifiche apportate allo stato di visualizzazione.

(Ereditato da HotSpot)

Si applica a

Vedi anche