ImageMap.HotSpotMode Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
Wartość właściwości
Jedna z HotSpotMode wartości wyliczenia. Wartość domyślna to NotSet
.
Wyjątki
Określony typ nie jest jedną z HotSpotMode wartości wyliczenia.
Przykłady
W poniższym przykładzie kodu pokazano, jak deklaratywnie utworzyć kontrolkę zawierającą ImageMap dwa RectangleHotSpot obiekty. Właściwość ImageMap.HotSpotMode jest ustawiona na HotSpotMode.PostBack
wartość , co powoduje, że strona będzie publikować z powrotem na serwerze za każdym razem, gdy użytkownik kliknie jeden z regionów gorącego miejsca. Właściwość HotSpotMode nie jest ustawiana na każdym obiekcie RectangleHotSpot , ponieważ pobierają swoje zachowanie z ImageMap.HotSpotMode właściwości. Aby ten przykład działał poprawnie, należy podać własny obraz dla ImageUrl właściwości i odpowiednio zaktualizować ścieżkę do obrazu, aby aplikacja mogła ją zlokalizować.
<%@ 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>
Uwagi
Użyj właściwości , HotSpotMode aby określić domyślne zachowanie HotSpot kliknięć obiektów w kontrolce ImageMap . Ta właściwość jest ustawiana przy użyciu jednej z HotSpotMode wartości wyliczenia. W poniższej tabeli wymieniono możliwe wartości.
Element | Opis |
---|---|
Inactive |
Obiekt HotSpot nie ma żadnego zachowania. |
NotSet |
Obiekt HotSpot używa zachowania ustawionego ImageMap przez właściwość kontrolki HotSpotMode . Jeśli kontrolka ImageMap nie definiuje zachowania, HotSpot wszystkie obiekty przechodzą do adresu URL. |
Navigate |
Obiekty HotSpot przechodzą do adresu URL. |
PostBack |
Obiekty HotSpot generują powrót do serwera. |
Zachowanie obiektu można określić HotSpot przy użyciu ImageMap.HotSpotMode właściwości ImageMap kontrolki lub HotSpot.HotSpotMode właściwości każdego obiektu HotSpot . Jeśli obie właściwości są ustawione, właściwość określona HotSpot.HotSpotMode dla każdego pojedynczego HotSpot obiektu ma pierwszeństwo przed ImageMap.HotSpotMode właściwością kontrolki ImageMap .
Po ustawieniu HotSpotMode właściwości kontrolki ImageMap należy pamiętać, że HotSpotMode.NotSet
wartości i HotSpotMode.Navigate
mają takie samo zachowanie: obaj przechodzą do adresu URL. Po określeniu HotSpotMode.NotSet
HotSpot.HotSpotMode właściwości pojedynczego HotSpot obiektu HotSpot określa jego zachowanie z wartości HotSpotMode właściwości kontrolki ImageMap .
Jeśli określisz HotSpotMode.Navigate
właściwość ImageMap.HotSpotMode , strona przechodzi do adresu URL po kliknięciu HotSpot . Użyj właściwości , NavigateUrl aby określić adres URL do przejścia.
Jeśli określisz HotSpotMode.PostBack
właściwość ImageMap.HotSpotMode , strona generuje powrót do serwera po kliknięciu HotSpot . Użyj właściwości , PostBackValue aby określić nazwę regionu hot spot. Ta nazwa zostanie przekazana w danych zdarzenia po wystąpieniu ImageMapEventArgs zdarzenia zwrotnego. Po kliknięciu po powrocie zwrotne HotSpot zdarzenie zostanie podniesione Click . Aby programowo kontrolować akcje wykonywane po kliknięciu postbacku HotSpot , podaj procedurę obsługi zdarzeń Click dla zdarzenia.
Jeśli określisz HotSpotMode.Inactive
właściwość, HotSpot obiekt nie ma żadnego zachowania po kliknięciuHotSpot.HotSpotMode. Tej wartości można użyć do utworzenia nieaktywnego miejsca gorącego w większym aktywnym miejscu gorącym. Ta opcja umożliwia tworzenie bardziej złożonych stref punktów gorących w ramach kontrolki ImageMap .
Aby utworzyć obszar nieaktywny w aktywnym miejscu gorącym, należy określić nieaktywne miejsce gorące przed aktywnym miejscem gorącym w kontrolce ImageMap . Na przykład następujące ImageMap definicje aktywnego pierścienia przez określenie nieaktywnego cyklicznego miejsca gorącego w większym aktywnym cyklicznym miejscu gorącym:
<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>
Aby spowodować, że wszystkie HotSpot obiekty w kontrolce ImageMap mają takie samo zachowanie, użyj HotSpotMode właściwości kontrolki ImageMap , aby określić zachowanie. Następnie ustaw HotSpotMode właściwość dla każdego obiektu HotSpot na wartość lub nie należy określać HotSpotMode.NotSet
wartości dla HotSpot.HotSpotMode właściwości.
Aby określić różne zachowania dla HotSpot obiektów w kontrolceImageMap, ustaw HotSpot.HotSpotMode właściwość dla każdego obiektu HotSpotHotSpotMode.Navigate
na wartość , lub HotSpotMode.PostBack
HotSpotMode.Inactive
.
Uwaga
ImageMap Jeśli właściwość kontrolki ImageMap.HotSpotMode lub HotSpot.HotSpotMode właściwość w dowolnym z HotSpot obiektów, które zawiera, jest ustawiona na HotSpotMode.NotSet
wartość lub nie jest ustawiona na wartość, domyślnie zachowanie to HotSpotMode.Navigate
.
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla