PolygonHotSpot Classe

  • Riferimento

Definizione

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

Definisce un'area sensibile a forma di poligono in un controllo ImageMap. La classe non può essere ereditata.

public ref class PolygonHotSpot sealed : System::Web::UI::WebControls::HotSpot
public sealed class PolygonHotSpot : System.Web.UI.WebControls.HotSpot
type PolygonHotSpot = class
    inherit HotSpot
Public NotInheritable Class PolygonHotSpot
Inherits HotSpot
Ereditarietà
Object
HotSpot
PolygonHotSpot

Esempio

Nell'esempio di codice seguente viene illustrato come creare un ImageMap controllo contenente tre PolygonHotSpot oggetti . Ogni PolygonHotSpot oggetto rappresenta un'area geografica sulla mappa. Quando l'utente fa clic su un PolygonHotSpot oggetto, esegue il postback al server e il tipo e il nome dell'area a caldo vengono visualizzati in un'etichetta.

<%@ 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 RegionMap_Clicked (object sender, ImageMapEventArgs e)
  {
    string hotSpotType;

    // When a user clicks a hot spot, display
    // the hot spot's type and name.
    switch (e.PostBackValue)
    {
      case "Western":
        hotSpotType = Regions.HotSpots[0].ToString();
        Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue;
        break;
        
      case "Northern":
        hotSpotType = Regions.HotSpots[1].ToString();
        Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue;
        break;

      case "Southern":
        hotSpotType = Regions.HotSpots[2].ToString();
        Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue;
        break;

      default:
        Message1.Text = "You did not click a valid hot spot region.";
        break;
    }
  }  
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>PolygonHotSpot Class Example</title>
</head>
  <body>
    <form id="Form1" runat="server">
    
      <h3>PolygonHotSpot Example</h3>
      
      <!-- Change or remove the width and height attributes as
           appropriate for your image. -->
      <asp:imagemap id="Regions"           
        imageurl="Images/RegionMap.jpg"
        alternatetext="Sales regions" 
        hotspotmode="PostBack"
        width="400"
        height="400"
        onclick="RegionMap_Clicked"   
        runat="Server">            
          
        <asp:PolygonHotSpot 
          coordinates="0,0,176,0,125,182,227,400,0,400"         
          postbackvalue="Western"
          alternatetext="Western Region">
        </asp:PolygonHotSpot>
          
        <asp:PolygonHotSpot 
          coordinates="177,0,400,0,400,223,335,154,127,180"         
          postbackvalue="Northern"
          alternatetext="Northern Region">
        </asp:PolygonHotSpot>
        
        <asp:PolygonHotSpot 
          coordinates="128,185,335,157,400,224,400,400,228,400"         
          postbackvalue="Southern"
          alternatetext="Southern Region">
        </asp:PolygonHotSpot>
      
      </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 RegionMap_Clicked(ByVal sender As Object, ByVal e As ImageMapEventArgs)
    Dim hotSpotType As String
        
    ' When a user clicks a hot spot, display
    ' the hot spot's type and name.
    Select Case (e.PostBackValue)
      
      Case ("Western")
        hotSpotType = Regions.HotSpots(0).ToString()
        Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue
      
      Case ("Northern")
        hotSpotType = Regions.HotSpots(1).ToString()
        Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue
      
      Case ("Southern")
        hotSpotType = Regions.HotSpots(2).ToString()
        Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue
      
      Case Else
        Message1.Text = "You did not click a valid hot spot region."
    
    End Select

  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>PolygonHotSpot Class Example</title>
</head>
  <body>
    <form id="Form1" runat="server">
    
      <h3>PolygonHotSpot Example</h3>
      
      <!-- Change or remove the width and height attributes as
           appropriate for your image. -->
      <asp:imagemap id="Regions"           
        imageurl="Images/RegionMap.jpg"
        alternatetext="Sales regions" 
        hotspotmode="PostBack"
        width="400"
        height="400"
        onclick="RegionMap_Clicked"   
        runat="Server">            
          
        <asp:PolygonHotSpot 
          coordinates="0,0,176,0,125,182,227,400,0,400"         
          postbackvalue="Western"
          alternatetext="Western Region">
        </asp:PolygonHotSpot>
          
        <asp:PolygonHotSpot 
          coordinates="177,0,400,0,400,223,335,154,127,180"         
          postbackvalue="Northern"
          alternatetext="Northern Region">
        </asp:PolygonHotSpot>
        
        <asp:PolygonHotSpot 
          coordinates="128,185,335,157,400,224,400,400,228,400"         
          postbackvalue="Southern"
          alternatetext="Southern Region">
        </asp:PolygonHotSpot>
      
      </asp:imagemap>
            
      <br /><br />
          
      <asp:label id="Message1"
        runat="Server">
      </asp:label>                 
                 
    </form>      
  </body>
</html>

Commenti

Questa classe definisce un'area ad accesso frequente a forma di poligono in un ImageMap controllo . L'oggetto PolygonHotSpot è utile per la definizione di aree a caldo a forma irregolare in un ImageMap controllo. Ad esempio, è possibile usarlo per definire singole aree all'interno di una mappa geografica.

Per definire l'area di un PolygonHotSpotoggetto , impostare la Coordinates proprietà su una stringa che specifica le coordinate di ogni vertice dell'oggetto PolygonHotSpot . Un vertice poligono è un punto in cui si incontrano due archi poligoni.

Quando si fa clic su un PolygonHotSpot oggetto, 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à HotSpotMode.Navigatesu e usare la NavigateUrl proprietà per specificare l'URL a cui passare. Per eseguire il postback al server, impostare la HotSpotMode proprietà HotSpotMode.PostBacksu e utilizzare la PostBackValue proprietà per specificare un nome per l'oggetto PolygonHotSpot . Questo nome verrà passato nei dati dell'evento ImageMapEventArgsPolygonHotSpot quando si fa clic su . Se si desidera che l'oggetto PolygonHotSpot non abbia alcun comportamento, impostare la HotSpotMode proprietà su HotSpotMode.Inactive.

Costruttori

PolygonHotSpot()

Inizializza una nuova istanza della classe PolygonHotSpot.

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)
Coordinates

Stringa di coordinate che rappresenta i vertici di un oggetto PolygonHotSpot.
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)
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)
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)
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 dei vertici di un oggetto PolygonHotSpot.
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