RectangleHotSpot Classe

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Definisce un'area del punto critico rettangolare in un ImageMap controllo . Questa 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à: Object

HotSpot
RectangleHotSpot

Esempio

Nell'esempio di codice seguente viene illustrato come creare in modo dichiarativo un ImageMap controllo che contiene due RectangleHotSpot oggetti. La ImageMap.HotSpotMode proprietà è impostata su HotSpotMode.PostBack, che determina la postback della pagina al server ogni volta che un utente fa clic su una delle aree ad accesso frequente. Ogni volta che l'utente fa clic su uno degli RectangleHotSpot oggetti, viene chiamato il GetCoordinates metodo e le coordinate del punto attivo selezionato 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 del punto critico 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. Set della Bottom proprietà sul valore che rappresenta la coordinata y dell'angolo inferiore destro dell'area rettangolare.

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

Costruttori

Nome	Descrizione
RectangleHotSpot()	Inizializza una nuova istanza della classe RectangleHotSpot.

Proprietà

Nome	Descrizione
AccessKey	Ottiene o imposta la chiave di accesso che consente di passare rapidamente all'area HotSpot . (Ereditato da HotSpot)
AlternateText	Ottiene o imposta il testo alternativo da visualizzare per un oggetto in un HotSpot ImageMap controllo quando l'immagine non è disponibile o ne esegue il rendering in 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 RectangleHotSpot oggetto.
HotSpotMode	Ottiene o imposta il comportamento di un oggetto in un HotSpot ImageMap controllo quando HotSpot si fa clic su . (Ereditato da HotSpot)
IsTrackingViewState	Ottiene un valore che indica se l'oggetto HotSpot sta monitorando le modifiche apportate allo stato di visualizzazione. (Ereditato da HotSpot)
Left	Ottiene o imposta la coordinata x del lato sinistro dell'area rettangolare definita da questo RectangleHotSpot oggetto.
MarkupName	In caso di override in una classe derivata, ottiene la rappresentazione di stringa per la HotSpot forma dell'oggetto. (Ereditato da HotSpot)
NavigateUrl	Ottiene o imposta l'URL a cui passare quando si fa clic su un HotSpot oggetto . (Ereditato da HotSpot)
PostBackValue	Ottiene o imposta il nome dell'oggetto HotSpot da passare ai dati dell'evento quando HotSpot si fa clic su . (Ereditato da HotSpot)
Right	Ottiene o imposta la coordinata x del lato destro dell'area rettangolare definita da questo RectangleHotSpot oggetto.
TabIndex	Ottiene o imposta l'indice della scheda 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 si fa clic su un HotSpot oggetto che passa a un URL. (Ereditato da HotSpot)
Top	Ottiene o imposta la coordinata y del lato superiore dell'area rettangolare definita da questo RectangleHotSpot oggetto.
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un HotSpot oggetto in più richieste per la stessa pagina. (Ereditato da HotSpot)

Metodi

Nome	Descrizione
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetCoordinates()	Restituisce una stringa che rappresenta la x -and coordinate y dell'angolo superiore sinistro di un RectangleHotSpot oggetto e le coordinate x e y dell'angolo inferiore destro.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
LoadViewState(Object)	Ripristina lo HotSpot stato di visualizzazione salvato in precedenza dell'oggetto nell'oggetto . (Ereditato da HotSpot)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
SaveViewState()	Salva le modifiche apportate allo HotSpot stato di visualizzazione dell'oggetto dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da HotSpot)
ToString()	Restituisce la String rappresentazione di questa istanza di un HotSpot oggetto . (Ereditato da HotSpot)
TrackViewState()	Fa in modo che l'oggetto HotSpot possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nell'oggetto dell'oggetto StateBag . Questo oggetto è accessibile tramite la ViewState proprietà . (Ereditato da HotSpot)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IStateManager.IsTrackingViewState	Ottiene un valore che indica se l'oggetto HotSpot sta monitorando le modifiche apportate allo stato di visualizzazione. (Ereditato da HotSpot)
IStateManager.LoadViewState(Object)	Ripristina lo HotSpot stato di visualizzazione salvato in precedenza dell'oggetto nell'oggetto . (Ereditato da HotSpot)
IStateManager.SaveViewState()	Salva le modifiche apportate allo HotSpot stato di visualizzazione dell'oggetto dopo l'ultima pubblicazione della pagina nel 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

Commenti e suggerimenti

Questa pagina è stata utile?