HotSpot.HotSpotMode Proprietà

  • Riferimento

Definizione

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

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

public:
 virtual property System::Web::UI::WebControls::HotSpotMode HotSpotMode { System::Web::UI::WebControls::HotSpotMode get(); void set(System::Web::UI::WebControls::HotSpotMode value); };
public virtual System.Web.UI.WebControls.HotSpotMode HotSpotMode { get; set; }
member this.HotSpotMode : System.Web.UI.WebControls.HotSpotMode with get, set
Public Overridable Property HotSpotMode As HotSpotMode

Valore della proprietà

HotSpotMode

Uno dei valori dell'enumerazione HotSpotMode. Il valore predefinito è Default.

Eccezioni

ArgumentOutOfRangeException

Il tipo specificato non è uno dei valori dell'enumerazione HotSpotMode.

Commenti

Utilizzare la proprietà per specificare il HotSpotMode comportamento di un oggetto in un HotSpotImageMap controllo quando viene HotSpot fatto clic. Questa proprietà è impostata usando uno dei valori di HotSpotMode enumerazione. Nella tabella seguente sono elencati i valori possibili.

Valore Descrizione
NotSet L'oggetto HotSpot utilizza il comportamento impostato dalla proprietà ImageMap del controllo HotSpotMode. Se il controllo non definisce il ImageMap comportamento, gli HotSpot oggetti passano a un URL.
Inactive L'oggetto HotSpot non ha alcun comportamento.
Navigate L'oggetto HotSpot causa lo spostamento su un URL.
PostBack L'oggetto HotSpot genera un postback al server.

È possibile specificare HotSpot il comportamento sulla HotSpotMode proprietà del controllo o sulla HotSpotMode proprietà di ogni singolo HotSpot oggetto. Se entrambe le proprietà vengono impostate, la proprietà specificata in ogni singolo HotSpot oggetto ha la HotSpotMode precedenza sulla proprietà sul HotSpotModeImageMap controllo.

Se si specifica HotSpotMode.NotSet per la HotSpotMode proprietà di un singolo HotSpot oggetto, il HotSpot comportamento viene ottenuto dalla proprietà del HotSpotMode controllo contenenteImageMap. In questo scenario, se la proprietà del HotSpotMode controllo non è impostata su un valore o è impostata su HotSpotMode.NotSet, il comportamento predefinito consiste nel ImageMap passare a un URL.

Se si specifica HotSpotMode.Navigate per la proprietà di un HotSpot oggetto, l'oggetto HotSpotModeHotSpot passa a un URL quando viene fatto clic sull'area del punto frequente. Utilizzare la NavigateUrl proprietà per specificare l'URL da passare.

Se si specifica HotSpotMode.PostBack per la proprietà di un HotSpot oggetto, l'oggetto HotSpotModeHotSpot genera un postback al server quando viene HotSpot fatto clic su . Utilizzare la PostBackValue proprietà per specificare un nome per .HotSpot Questo nome verrà passato nei dati dell'evento ImageMapEventArgs quando si verifica un evento postback. Quando viene fatto clic su un postback HotSpot , viene generato l'evento Click . Per controllare a livello di codice le azioni eseguite quando viene fatto clic su un postback HotSpot , specificare un gestore eventi per l'evento Click .

Per consentire a tutti gli HotSpot oggetti in un ImageMap controllo di avere lo stesso comportamento, impostare la HotSpot.HotSpotMode proprietà su ogni singolo HotSpot oggetto su HotSpotMode.NotSet o non specificare un valore per la HotSpot.HotSpotMode proprietà.

Per specificare comportamenti diversi per HotSpot gli oggetti in un ImageMap controllo, impostare la HotSpot.HotSpotMode proprietà su ogni singolo HotSpot oggetto su HotSpotMode.Navigate, HotSpotMode.PostBacko HotSpotMode.Inactive.

Nota

Se la proprietà o la HotSpot.HotSpotMode proprietà di ImageMap.HotSpotMode un ImageMap controllo sugli HotSpot oggetti che contiene non è impostata su un valore o impostata su HotSpotMode.NotSet, per impostazione predefinita il comportamento è HotSpotMode.Navigate.

Se si specifica HotSpotMode.Inactive per la proprietà, l'oggetto HotSpot.HotSpotModeHotSpot non ha alcun comportamento quando viene fatto clic. È possibile usare questo valore per creare un punto caldo inattivo all'interno di un punto caldo attivo più grande. Questa opzione viene fornita per consentire di creare zone di hot spot più complesse all'interno di un ImageMap controllo.

Per creare un'area inattiva all'interno di un punto caldo attivo, è necessario specificare il punto di accesso inattivo prima del punto di accesso attivo nel ImageMap controllo. Ad esempio, il seguente ImageMap definisce un anello attivo specificando un punto caldo circolare inattivo all'interno di un punto caldo circolare più grande:

<asp:ImageMap ID="SaturnImage"
  ImageUrl="~/saturn.PNG"
  runat="server" OnClick="SaturnImage_Click">
  <asp:CircleHotSpot AlternateText="planet" HotSpotMode=PostBack
    PostBackValue="planet" Radius=40 X=100 Y=100 />
  <asp:CircleHotSpot HotSpotMode=Inactive
    Radius=60 X=100 Y=100 />
  <asp:CircleHotSpot AlternateText="rings" HotSpotMode=PostBack
    PostBackValue="rings" Radius=80 X=100 Y=100 />
</asp:ImageMap>

Si applica a

Vedi anche