PolygonHotSpot PolygonHotSpot PolygonHotSpot PolygonHotSpot Class

Definizione

Definisce un'area sensibile a forma di poligono in un controllo ImageMap.Defines a polygon-shaped hot spot region in an ImageMap control. Questa classe non può essere ereditata.This class cannot be inherited.

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à
PolygonHotSpotPolygonHotSpotPolygonHotSpotPolygonHotSpot

Esempi

Nell'esempio di codice riportato di seguito viene illustrato ImageMap come creare un controllo PolygonHotSpot che contiene tre oggetti.The following code example demonstrates how to create an ImageMap control that contains three PolygonHotSpot objects. Ogni PolygonHotSpot oggetto rappresenta un'area geografica sulla mappa.Each PolygonHotSpot object represents a geographical region on the map. Quando l'utente fa clic PolygonHotSpot su un oggetto, esegue il postback al server e il tipo e il nome dell'area sensibile vengono visualizzati in un'etichetta.When the user clicks a PolygonHotSpot object, it posts back to the server and the type and name of the hot spot are displayed in a label.

<%@ 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 sensibile a forma di poligono in ImageMap un controllo.This class defines a polygon-shaped hot spot region in an ImageMap control. L' PolygonHotSpot oggetto è utile per la definizione di aree sensibili a forma irregolare in un ImageMap controllo.The PolygonHotSpot is useful for defining irregularly shaped hot spot regions in an ImageMap control. Ad esempio, è possibile usarlo per definire singole aree all'interno di una mappa geografica.For example, you can use it to define individual regions within a geographical map.

Per definire l'area di un PolygonHotSpot, impostare la Coordinates proprietà su una stringa che specifica le coordinate PolygonHotSpot di ogni vertice dell'oggetto.To define the region of a PolygonHotSpot, set the Coordinates property to a string that specifies the coordinates of each vertex of the PolygonHotSpot object. Un vertice poligono è un punto in cui due bordi del poligono soddisfano.A polygon vertex is a point at which two polygon edges meet.

Quando si PolygonHotSpot fa clic su un oggetto, la pagina passa a un URL, genera un postback al server o non esegue alcuna operazione.When a PolygonHotSpot object is clicked, the page navigates to a URL, generates a post back to the server, or does nothing. La HotSpotMode proprietà specifica questo comportamento.The HotSpotMode property specifies this behavior. Per passare a un URL, impostare la HotSpotMode proprietà su HotSpotMode.Navigatee usare la NavigateUrl proprietà per specificare l'URL a cui passare.To navigate to a URL, set the HotSpotMode property to HotSpotMode.Navigate, and use the NavigateUrl property to specify the URL to navigate to. Per eseguire il postback al server, impostare la HotSpotMode proprietà su HotSpotMode.PostBacke utilizzare la PostBackValue proprietà per specificare un nome per l' PolygonHotSpot oggetto.To post back to the server, set the HotSpotMode property to HotSpotMode.PostBack, and use the PostBackValue property to specify a name for the PolygonHotSpot object. Questo nome verrà passato nei ImageMapEventArgs dati dell'evento PolygonHotSpot quando si fa clic su.This name will be passed in the ImageMapEventArgs event data when the PolygonHotSpot is clicked. Se si desidera che PolygonHotSpot l'oggetto non abbia alcun comportamento, impostare HotSpotMode la proprietà HotSpotMode.Inactivesu.If you want the PolygonHotSpot object to have no behavior, set the HotSpotMode property to HotSpotMode.Inactive.

Costruttori

PolygonHotSpot() PolygonHotSpot() PolygonHotSpot() PolygonHotSpot()

Inizializza una nuova istanza della classe PolygonHotSpot.Initializes a new instance of the PolygonHotSpot class.

Proprietà

AccessKey AccessKey AccessKey AccessKey

Ottiene o imposta il tasto di scelta che consente di spostarsi rapidamente sull'area HotSpot.Gets or sets the access key that allows you to quickly navigate to the HotSpot region.

(Inherited from HotSpot)
AlternateText AlternateText AlternateText 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.Gets or sets the alternate text to display for a HotSpot object in an ImageMap control when the image is unavailable or renders to a browser that does not support images.

(Inherited from HotSpot)
Coordinates Coordinates Coordinates Coordinates

Stringa di coordinate che rappresenta i vertici di un oggetto PolygonHotSpot.A string of coordinates that represents the vertexes of a PolygonHotSpot object.

HotSpotMode HotSpotMode HotSpotMode HotSpotMode

Ottiene o imposta il comportamento di un oggetto HotSpot in un controllo ImageMap quando viene fatto clic su HotSpot.Gets or sets the behavior of a HotSpot object in an ImageMap control when the HotSpot is clicked.

(Inherited from HotSpot)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Ottiene un valore che indica se l'oggetto HotSpot tiene traccia delle modifiche apportate al relativo stato di visualizzazione.Gets a value indicating whether the HotSpot object is tracking its view-state changes.

(Inherited from HotSpot)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ottiene un valore che indica se l'oggetto HotSpot tiene traccia delle modifiche apportate al relativo stato di visualizzazione.Gets a value indicating whether the HotSpot object is tracking its view-state changes.

(Inherited from HotSpot)
MarkupName MarkupName MarkupName MarkupName

Quando viene sottoposto a override in una classe derivata, ottiene la rappresentazione in formato stringa della forma dell'oggetto HotSpot.When overridden in a derived class, gets the string representation for the HotSpot object's shape.

(Inherited from HotSpot)
NavigateUrl NavigateUrl NavigateUrl NavigateUrl

Ottiene o imposta l'URL a cui passare quando viene fatto clic su un oggetto HotSpot.Gets or sets the URL to navigate to when a HotSpot object is clicked.

(Inherited from HotSpot)
PostBackValue PostBackValue PostBackValue PostBackValue

Ottiene o imposta il nome dell'oggetto HotSpot da passare nei dati dell'evento quando viene fatto clic su HotSpot.Gets or sets the name of the HotSpot object to pass in the event data when the HotSpot is clicked.

(Inherited from HotSpot)
TabIndex TabIndex TabIndex TabIndex

Ottiene o imposta l'indice di tabulazione dell'area HotSpot.Gets or sets the tab index of the HotSpot region.

(Inherited from HotSpot)
Target Target Target 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.Gets or sets the target window or frame in which to display the Web page content linked to when a HotSpot object that navigates to a URL is clicked.

(Inherited from HotSpot)
ViewState ViewState ViewState 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.Gets a dictionary of state information that allows you to save and restore the view state of a HotSpot object across multiple requests for the same page.

(Inherited from HotSpot)

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetCoordinates() GetCoordinates() GetCoordinates() GetCoordinates()

Restituisce una stringa che rappresenta le coordinate dei vertici di un oggetto PolygonHotSpot.Returns a string that represents the coordinates of the vertexes of a PolygonHotSpot object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Ripristina lo stato di visualizzazione precedentemente salvato dell'oggetto HotSpot.Restores the HotSpot object's previously saved view state to the object.

(Inherited from HotSpot)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione dell'oggetto HotSpot dal momento in cui è stato eseguito il postback della pagina al server.Saves the changes to the HotSpot object's view state since the time the page was posted back to the server.

(Inherited from HotSpot)
ToString() ToString() ToString() ToString()

Restituisce la rappresentazione String di questa istanza di un oggetto HotSpot.Returns the String representation of this instance of a HotSpot object.

(Inherited from HotSpot)
TrackViewState() TrackViewState() TrackViewState() 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.Causes the HotSpot object to track changes to its view state so they can be stored in the object's StateBag object. È possibile accedere a questo oggetto tramite la proprietà ViewState.This object is accessible through the ViewState property.

(Inherited from HotSpot)

Implementazioni dell'interfaccia esplicita

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Ripristina lo stato di visualizzazione precedentemente salvato dell'oggetto HotSpot.Restores the HotSpot object's previously saved view state to the object.

(Inherited from HotSpot)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Salva le modifiche apportate allo stato di visualizzazione dell'oggetto HotSpot dall'ultimo postback della pagina al server.Saves the changes to the HotSpot object's view state since the last time the page was posted back to the server.

(Inherited from HotSpot)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Indica all'area HotSpot di tenere traccia delle modifiche apportate allo stato di visualizzazione.Instructs the HotSpot region to track changes to its view state.

(Inherited from HotSpot)

Si applica a

Vedi anche