RectangleHotSpot Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет прямоугольную активную область для указателя мыши в элементе управления ImageMap. Этот класс не наследуется.
public ref class RectangleHotSpot sealed : System::Web::UI::WebControls::HotSpotpublic sealed class RectangleHotSpot : System.Web.UI.WebControls.HotSpottype RectangleHotSpot = class
inherit HotSpotPublic NotInheritable Class RectangleHotSpot
Inherits HotSpot- Наследование
Примеры
В следующем примере кода показано, как декларативно создать ImageMap элемент управления, содержащий два RectangleHotSpot объекта . Свойству ImageMap.HotSpotMode присвоено значение HotSpotMode.PostBack, что приводит к тому, что страница будет отправлять данные на сервер каждый раз, когда пользователь щелкает один из регионов горячей точки. Каждый раз, когда пользователь щелкает один из RectangleHotSpot объектов, GetCoordinates вызывается метод и отображаются координаты выбранной горячей точки для пользователя. Чтобы этот пример работал правильно, необходимо указать собственный образ для ImageUrl свойства и соответствующим образом обновить путь к образу, чтобы приложение я ху хи хи.
<%@ 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)
{
string coordinates;
string hotSpotType;
int yescount = ((ViewState["yescount"] != null)? (int)ViewState["yescount"] : 0);
int nocount = ((ViewState["nocount"] != null)? (int)ViewState["nocount"] : 0);
// When a user clicks the "Yes" hot spot,
// display the hot spot's name and coordinates.
if (e.PostBackValue.Contains("Yes"))
{
yescount += 1;
coordinates = Vote.HotSpots[0].GetCoordinates();
hotSpotType = Vote.HotSpots[0].ToString ();
Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue + ".<br />" +
"The coordinates are " + coordinates + ".<br />" +
"The current vote count is " + yescount.ToString() +
" yes votes and " + nocount.ToString() + " no votes.";
}
// When a user clicks the "No" hot spot,
// display the hot spot's name and coordinates.
else if (e.PostBackValue.Contains("No"))
{
nocount += 1;
coordinates = Vote.HotSpots[1].GetCoordinates();
hotSpotType = Vote.HotSpots[1].ToString ();
Message1.Text = "You selected " + hotSpotType + " " + e.PostBackValue + ".<br />" +
"The coordinates are " + coordinates + ".<br />" +
"The current vote count is " + yescount.ToString() +
" yes votes and " + nocount.ToString() + " no votes.";
}
else
{
Message1.Text = "You did not click a valid hot spot region.";
}
ViewState["yescount"] = yescount;
ViewState["nocount"] = nocount;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>ImageMap Class Post Back Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageMap Class Post Back Example</h3>
<asp:imagemap id="Vote"
imageurl="Images/VoteImage.jpg"
width="400"
height="200"
alternatetext="Vote Yes or No"
hotspotmode="PostBack"
onclick="VoteMap_Clicked"
runat="Server">
<asp:RectangleHotSpot
top="0"
left="0"
bottom="200"
right="200"
postbackvalue="Yes"
alternatetext="Vote yes">
</asp:RectangleHotSpot>
<asp:RectangleHotSpot
top="0"
left="201"
bottom="200"
right="400"
postbackvalue="No"
alternatetext="Vote no">
</asp:RectangleHotSpot>
</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 VoteMap_Clicked(ByVal sender As Object, ByVal e As ImageMapEventArgs)
Dim coordinates As String
Dim hotSpotType As String
Dim yescount As Integer
Dim nocount As Integer
If (ViewState("yescount") IsNot Nothing) Then
yescount = Convert.ToInt32(ViewState("yescount"))
Else
yescount = 0
End If
If (ViewState("nocount") IsNot Nothing) Then
nocount = Convert.ToInt32(ViewState("nocount"))
Else
nocount = 0
End If
' When a user clicks the "Yes" hot spot,
' display the hot spot's name and coordinates.
If (e.PostBackValue.Contains("Yes")) Then
yescount += 1
coordinates = Vote.HotSpots(0).GetCoordinates()
hotSpotType = Vote.HotSpots(0).ToString()
Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue & ".<br />" & _
"The coordinates are " & coordinates & ".<br />" & _
"The current vote count is " & yescount.ToString() & _
" yes votes and " & nocount.ToString() & " no votes."
' When a user clicks the "No" hot spot,
' display the hot spot's name and coordinates.
ElseIf (e.PostBackValue.Contains("No")) Then
nocount += 1
coordinates = Vote.HotSpots.Item(1).GetCoordinates()
hotSpotType = Vote.HotSpots.Item(1).ToString()
Message1.Text = "You selected " & hotSpotType & " " & e.PostBackValue & ".<br />" & _
"The coordinates are " & coordinates & ".<br />" & _
"The current vote count is " & yescount.ToString() & _
" yes votes and " & nocount.ToString() & " no votes."
Else
Message1.Text = "You did not click a valid hot spot region."
End If
ViewState("yescount") = yescount
ViewState("nocount") = nocount
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="head1" runat="server">
<title>ImageMap Class Post Back Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageMap Class Post Back Example</h3>
<asp:imagemap id="Vote"
imageurl="Images/VoteImage.jpg"
width="400"
height="200"
alternatetext="Vote Yes or No"
hotspotmode="PostBack"
onclick="VoteMap_Clicked"
runat="Server">
<asp:RectangleHotSpot
top="0"
left="0"
bottom="200"
right="200"
postbackvalue="Yes"
alternatetext="Vote yes">
</asp:RectangleHotSpot>
<asp:RectangleHotSpot
top="0"
left="201"
bottom="200"
right="400"
postbackvalue="No"
alternatetext="Vote no">
</asp:RectangleHotSpot>
</asp:imagemap>
<br /><br />
<asp:label id="Message1"
runat="Server">
</asp:label>
</form>
</body>
</html>
Комментарии
Этот класс определяет прямоугольную область горячей точки в элементе ImageMap управления . Чтобы определить область RectangleHotSpot объекта, присвойте Left свойству значение, представляющее координату X верхнего левого угла прямоугольной области. Присвойте Top свойству значение, представляющее координату Y верхнего левого угла прямоугольной области. Присвойте Right свойству значение, представляющее координату X правого нижнего угла прямоугольной области. Bottom Задайте для свойства значение, представляющее координату Y правого нижнего угла прямоугольной области.
При щелчке RectangleHotSpot элемента управления страница переходит по URL-адресу, создает запись обратно на сервер или ничего не делает. Это HotSpotMode поведение определяется свойством . Чтобы перейти к URL-адресу, задайте свойству HotSpotMode значение HotSpotMode.Navigate и используйте NavigateUrl свойство , чтобы указать URL-адрес для перехода. Чтобы выполнить обратную отправку на сервер, присвойте свойству HotSpotModePostBackValue значение HotSpotMode.PostBack и используйте свойство , чтобы указать имя объекта RectangleHotSpot . Это имя будет передано ImageMapEventArgs в данные события при щелчке RectangleHotSpot . . Если требуется HotSpot , чтобы у объекта не было поведения, присвойте свойству HotSpotMode значение HotSpotMode.Inactive.
Конструкторы
| RectangleHotSpot() |
Инициализирует новый экземпляр класса RectangleHotSpot. |
Свойства
| AccessKey |
Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к области HotSpot. (Унаследовано от HotSpot) |
| AlternateText |
Возвращает или задает альтернативный текст, отображаемый для объекта HotSpot в элементе управления ImageMap в случае недоступности изображения или отрисовки для просмотра в браузере, не поддерживающем изображения. (Унаследовано от HotSpot) |
| Bottom |
Получает или задает координату y нижней стороны прямоугольной зоны, определяемой данным объектом RectangleHotSpot. |
| HotSpotMode |
Возвращает или задает поведение объекта HotSpot в элементе управления ImageMap при щелчке HotSpot. (Унаследовано от HotSpot) |
| IsTrackingViewState |
Получает значение, указывающее, отслеживает ли объект HotSpot изменения в данных о своем состоянии представления. (Унаследовано от HotSpot) |
| Left |
Получает или задает координату x левой границы прямоугольной зоны, определяемой данным объектом RectangleHotSpot. |
| MarkupName |
При переопределении в производном классе возвращает строковое представление для фигуры объекта HotSpot. (Унаследовано от HotSpot) |
| NavigateUrl |
Возвращает или задает URL-адрес для перехода при щелчке объекта HotSpot. (Унаследовано от HotSpot) |
| PostBackValue |
Возвращает или задает имя объекта HotSpot, передаваемое в связанных с событием данных при щелчке объекта HotSpot. (Унаследовано от HotSpot) |
| Right |
Получает или задает координату x правой границы прямоугольной зоны, определяемой данным объектом RectangleHotSpot. |
| TabIndex |
Возвращает или задает индекс перехода по клавише TAB для области HotSpot. (Унаследовано от HotSpot) |
| Target |
Возвращает или задает целевое окно или фрейм, в которых отображается содержимое веб-страницы, на которую указывает ссылка, при щелчке объекта HotSpot, осуществляющего переход по заданному URL-адресу. (Унаследовано от HotSpot) |
| Top |
Получает или задает координату y верхней границы прямоугольной зоны, определяемой данным объектом RectangleHotSpot. |
| ViewState |
Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления объекта HotSpot при нескольких запросах одной и той же страницы. (Унаследовано от HotSpot) |
Методы
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetCoordinates() |
Возвращает строку, представляющую координаты x и y верхнего левого угла объекта RectangleHotSpot и координаты x и y его нижнего правого угла. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| LoadViewState(Object) |
Восстанавливает сохраненное раннее состояние представления объекта HotSpot. (Унаследовано от HotSpot) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| SaveViewState() |
Сохраняет изменения в данных о состоянии представления объекта HotSpot после обратной передачи страницы на сервер. (Унаследовано от HotSpot) |
| ToString() |
Возвращает представление типа String для данного экземпляра объекта HotSpot. (Унаследовано от HotSpot) |
| TrackViewState() |
Инициирует отслеживание объектом HotSpot изменений в состоянии его представления для сохранения этих изменений в объекте StateBag данного объекта. Этот объект доступен с помощью свойства ViewState. (Унаследовано от HotSpot) |
Явные реализации интерфейса
| IStateManager.IsTrackingViewState |
Получает значение, указывающее, отслеживает ли объект HotSpot изменения в данных о своем состоянии представления. (Унаследовано от HotSpot) |
| IStateManager.LoadViewState(Object) |
Восстанавливает сохраненное раннее состояние представления объекта HotSpot. (Унаследовано от HotSpot) |
| IStateManager.SaveViewState() |
Сохраняет изменения в состоянии представления объекта HotSpot, произошедшие с момента последней обратной передачи данных страницы на сервер. (Унаследовано от HotSpot) |
| IStateManager.TrackViewState() |
Указывает на необходимость отслеживания изменений в области HotSpot. (Унаследовано от HotSpot) |
