ImageMap.HotSpotMode Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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, setPublic Overridable Property HotSpotMode As HotSpotModeWaarde van eigenschap
Een van de HotSpotMode opsommingswaarden. De standaardwaarde is NotSet.
Uitzonderingen
Het opgegeven type is geen van de HotSpotMode opsommingswaarden.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u declaratief een ImageMap besturingselement maakt dat twee RectangleHotSpot objecten bevat. De ImageMap.HotSpotMode eigenschap is ingesteld op HotSpotMode.PostBack, waardoor de pagina telkens weer op de server wordt geplaatst wanneer een gebruiker op een van de hot spot-regio's klikt. De HotSpotMode eigenschap is niet ingesteld op elk van de RectangleHotSpot objecten omdat ze hun gedrag van de ImageMap.HotSpotMode eigenschap krijgen. Als dit voorbeeld correct werkt, moet u uw eigen installatiekopieën voor de ImageUrl eigenschap opgeven en het pad naar de afbeelding op de juiste manier bijwerken, zodat de toepassing deze kan vinden.
<%@ 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)
{
// When a user clicks the "Yes" hot spot,
// display the hot spot's value.
if (e.PostBackValue == "Yes")
Message1.Text = "You selected " + e.PostBackValue + ".";
else if (e.PostBackValue == "No")
// When a user clicks the "No" hot spot,
// display the hot spot's value.
Message1.Text = "You selected " + e.PostBackValue + ".";
else
Message1.Text = "You did not click a valid hot spot region.";
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>ImageMap.HotSpotMode Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageMap.HotSpotMode Example</h3>
<!--The RectangleHotSpot objects have the post back
behavior specified by the HotSpotMode
property on the ImageMap control.-->
<asp:imagemap id="Vote"
imageurl="Images/VoteImage.jpg"
alternatetext="Voting choices"
hotspotmode="PostBack"
onclick="VoteMap_Clicked"
runat="Server">
<asp:RectangleHotSpot
top="0"
left="0"
bottom="354"
right="250"
postbackvalue="Yes"
alternatetext="Vote yes">
</asp:RectangleHotSpot>
<asp:RectangleHotSpot
top="0"
left="251"
bottom="354"
right="500"
postbackvalue="No"
alternatetext="Vote no">
</asp:RectangleHotSpot>
</asp:imagemap>
<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)
' When a user clicks the "Yes" hot spot,
' display the hot spot's value.
If (e.PostBackValue = "Yes") Then
Message1.Text = "You selected " & e.PostBackValue & "."
' When a user clicks the "No" hot spot,
' display the hot spot's value.
ElseIf (e.PostBackValue = "No") Then
Message1.Text = "You selected " & e.PostBackValue & "."
Else
Message1.Text = "You did not click a valid hot spot region."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>ImageMap.HotSpotMode Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageMap.HotSpotMode Example</h3>
<!--The RectangleHotSpot objects have the post back
behavior specified by the HotSpotMode
property on the ImageMap control.-->
<asp:imagemap id="Vote"
imageurl="Images/VoteImage.jpg"
alternatetext="Voting choices"
hotspotmode="PostBack"
onclick="VoteMap_Clicked"
runat="Server">
<asp:RectangleHotSpot
top="0"
left="0"
bottom="354"
right="250"
postbackvalue="Yes"
alternatetext="Vote yes">
</asp:RectangleHotSpot>
<asp:RectangleHotSpot
top="0"
left="251"
bottom="354"
right="500"
postbackvalue="No"
alternatetext="Vote no">
</asp:RectangleHotSpot>
</asp:imagemap>
<br />
<asp:label id="Message1"
runat="Server">
</asp:label>
</form>
</body>
</html>
Opmerkingen
Gebruik de HotSpotMode eigenschap om het standaardgedrag van klikken op te geven van de HotSpot objecten in een ImageMap besturingselement. Deze eigenschap wordt ingesteld met behulp van een van de HotSpotMode opsommingswaarden. De volgende tabel bevat de mogelijke waarden.
| Item | Beschrijving |
|---|---|
Inactive |
Het HotSpot object heeft geen gedrag. |
NotSet |
Het HotSpot object 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 allemaal naar een URL. |
Navigate |
De HotSpot objecten navigeren naar een URL. |
PostBack |
De HotSpot objecten genereren een postback naar de server. |
U kunt het gedrag van een HotSpot object opgeven met behulp van de ImageMap.HotSpotMode eigenschap van het ImageMap besturingselement of de HotSpot.HotSpotMode eigenschap van elk afzonderlijk HotSpot object. Als beide eigenschappen zijn ingesteld, heeft de HotSpot.HotSpotMode eigenschap die is opgegeven voor elk afzonderlijk HotSpot object voorrang op de ImageMap.HotSpotMode eigenschap in het ImageMap besturingselement.
Wanneer u de HotSpotMode eigenschap van het ImageMap besturingselement instelt, moet u er rekening mee houden dat de HotSpotMode.NotSet waarden HotSpotMode.Navigate hetzelfde gedrag hebben: beide navigeren naar een URL. Wanneer u opgeeft HotSpotMode.NotSet voor de HotSpot.HotSpotMode eigenschap van een afzonderlijk HotSpot object, bepaalt dit HotSpot het gedrag van de waarde van de HotSpotMode eigenschap van het ImageMap besturingselement.
Als u opgeeft HotSpotMode.Navigate voor de ImageMap.HotSpotMode eigenschap, navigeert de pagina naar een URL wanneer erop HotSpot wordt geklikt. Gebruik de NavigateUrl eigenschap om de URL op te geven waarnaar u wilt navigeren.
Als u opgeeft HotSpotMode.PostBack voor de ImageMap.HotSpotMode eigenschap, genereert de pagina een postback naar de server wanneer erop HotSpot wordt geklikt. Gebruik de PostBackValue eigenschap om de naam van de hot spot-regio 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 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>
Als u wilt dat alle HotSpot objecten in een ImageMap besturingselement hetzelfde gedrag hebben, gebruikt u de HotSpotMode eigenschap op het ImageMap besturingselement om het gedrag op te geven. Stel vervolgens de HotSpotMode eigenschap voor elk afzonderlijk HotSpot object HotSpotMode.NotSet in of geef geen waarde op voor de HotSpot.HotSpotMode eigenschap.
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 een van de HotSpot objecten die het bevat, is ingesteld op of niet is ingesteld HotSpotMode.NotSet op een waarde, is HotSpotMode.Navigatehet gedrag standaard .
