HotSpot.HotSpotMode Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Hiermee wordt het gedrag van een HotSpot object in een ImageMap besturingselement opgehaald of ingesteld wanneer erop HotSpot wordt geklikt.

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

Waarde van eigenschap

HotSpotMode

Een van de HotSpotMode opsommingswaarden. De standaardwaarde is Default.

Uitzonderingen

ArgumentOutOfRangeException

Het opgegeven type is geen van de HotSpotMode opsommingswaarden.

Opmerkingen

Gebruik de HotSpotMode eigenschap om het gedrag van een HotSpot object in een ImageMap besturingselement op te geven wanneer erop HotSpot wordt geklikt. Deze eigenschap wordt ingesteld met behulp van een van de HotSpotMode opsommingswaarden. De volgende tabel bevat de mogelijke waarden.

Waarde Beschrijving
NotSet Het HotSpot gebruikt het gedrag dat is ingesteld door de eigenschap van ImageMap het HotSpotMode besturingselement. Als het ImageMap besturingselement het gedrag niet definieert, navigeren de HotSpot objecten naar een URL.
Inactive Het HotSpot heeft geen gedrag.
Navigate Hiermee HotSpot navigeert u naar een URL.
PostBack Hiermee HotSpot wordt een postback naar de server gegenereerd.

U kunt gedrag opgeven HotSpot voor de eigenschap van het HotSpotMode besturingselement of voor de HotSpotMode eigenschap van elk afzonderlijk HotSpot object. Als beide eigenschappen zijn ingesteld, heeft de HotSpotMode eigenschap die is opgegeven voor elk afzonderlijk HotSpot object voorrang op de HotSpotMode eigenschap in het ImageMap besturingselement.

Als u opgeeft HotSpotMode.NotSet voor de HotSpotMode eigenschap van een afzonderlijk HotSpot object, wordt het HotSpot gedrag ervan opgehaald uit de eigenschap van ImageMap het betreffende HotSpotMode besturingselement. In dit scenario, als de eigenschap van ImageMap het HotSpotMode besturingselement niet is ingesteld op een waarde of is ingesteld HotSpotMode.NotSetop, is het standaardgedrag om naar een URL te navigeren.

Als u opgeeft HotSpotMode.Navigate voor de HotSpotMode eigenschap van een HotSpot object, navigeert het HotSpot object naar een URL wanneer op de hot spot-regio wordt geklikt. Gebruik de NavigateUrl eigenschap om de URL op te geven waarnaar u wilt navigeren.

Als u opgeeft HotSpotMode.PostBack voor de HotSpotMode eigenschap van een HotSpot object, genereert het HotSpot object een post terug naar de server wanneer erop HotSpot wordt geklikt. Gebruik de PostBackValue eigenschap om een naam voor de HotSpoteigenschap op te geven. Deze naam wordt doorgegeven in de ImageMapEventArgs gebeurtenisgegevens wanneer er een terugvalgebeurtenis plaatsvindt. Wanneer er op een terugdraaiactie HotSpot wordt geklikt, wordt de Click gebeurtenis gegenereerd. Als u programmatisch de acties wilt beheren die worden uitgevoerd wanneer op een postback HotSpot wordt geklikt, geeft u een gebeurtenis-handler op voor de Click gebeurtenis.

Als u wilt dat alle HotSpot objecten in een ImageMap besturingselement hetzelfde gedrag hebben, stelt u de HotSpot.HotSpotMode eigenschap voor elk afzonderlijk HotSpot object HotSpotMode.NotSet in op of geeft u geen waarde voor de HotSpot.HotSpotMode eigenschap op.

Als u verschillende gedragingen voor HotSpot objecten in een ImageMap besturingselement wilt opgeven, stelt u de HotSpot.HotSpotMode eigenschap voor elk afzonderlijk HotSpot object HotSpotMode.Navigatein op , HotSpotMode.PostBackof HotSpotMode.Inactive.

Note

Als de eigenschap van een ImageMap besturingselement ImageMap.HotSpotMode of de HotSpot.HotSpotMode eigenschap op de HotSpot objecten die het bevat, niet is ingesteld op een waarde of is ingesteld HotSpotMode.NotSetop , is HotSpotMode.Navigatehet gedrag standaard .

Als u opgeeft HotSpotMode.Inactive voor de HotSpot.HotSpotMode eigenschap, heeft het HotSpot object geen gedrag wanneer erop wordt geklikt. U kunt deze waarde gebruiken om een inactieve hot spot te maken binnen een grotere actieve hot spot. Deze optie biedt u de mogelijkheid om complexere hot spot-zones binnen een ImageMap besturingselement te maken.

Als u een inactief gebied wilt maken binnen een actieve hot spot, moet u de inactieve hot spot opgeven vóór de actieve hot spot in het ImageMap besturingselement. Met het volgende ImageMap wordt bijvoorbeeld een actieve ring gedefinieerd door een inactieve cirkelvormige hot spot op te geven binnen een grotere actieve cirkelvormige hot spot:

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

Van toepassing op

Zie ook