ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вызывается основным приложением разработки, когда пользователь во время разработки щелкает сопоставленный элемент управления.
protected:
virtual void OnClick(System::Web::UI::Design::DesignerRegionMouseEventArgs ^ e);protected virtual void OnClick (System.Web.UI.Design.DesignerRegionMouseEventArgs e);abstract member OnClick : System.Web.UI.Design.DesignerRegionMouseEventArgs -> unit
override this.OnClick : System.Web.UI.Design.DesignerRegionMouseEventArgs -> unitProtected Overridable Sub OnClick (e As DesignerRegionMouseEventArgs)Параметры
Объект DesignerRegionMouseEventArgs, указывающий расположение и, возможно, область конструктора элементов управления, где пользователь выполняет щелчок.
Примеры
В следующем примере кода показано, как использовать обработчик для события в доступной для OnClick щелчка области элемента управления и использовать DesignerRegionMouseEventArgs объект для идентификации области, которую щелкают.
Этот пример кода является частью более крупного примера кода для EditableDesignerRegion класса .
// Handler for the Click event, which provides the region in the arguments.
protected override void OnClick(DesignerRegionMouseEventArgs e)
{
if (e.Region == null)
return;
// If the clicked region is not a header, return
if (e.Region.Name.IndexOf("Header") != 0)
return;
// Switch the current view if required
if (e.Region.Name.Substring(6, 1) != myControl.CurrentView.ToString())
{
myControl.CurrentView = int.Parse(e.Region.Name.Substring(6, 1));
base.UpdateDesignTimeHtml();
}
}
' Handler for the Click event, which provides the region in the arguments.
Protected Overrides Sub OnClick(ByVal e As DesignerRegionMouseEventArgs)
If IsNothing(e.Region) Then
Return
End If
' If the clicked region is not a header, return
If e.Region.Name.IndexOf("Header") <> 0 Then
Return
End If
' Switch the current view if required
If e.Region.Name.Substring(6, 1) <> myControl.CurrentView.ToString() Then
myControl.CurrentView = Integer.Parse(e.Region.Name.Substring(6, 1))
MyBase.UpdateDesignTimeHtml()
End If
End Sub
Комментарии
Событие ViewEvent вызывается узлом разработки для определенных действий с элементом управления в области конструктора. Например, событие вызывается для следующих условий:
Пользователь щелкает элемент управления .
Конструктор элементов управления рисует область конструктора.
Пользователь переходит в режим редактирования шаблона для элемента управления или выходит из нее.
Класс ControlDesigner предоставляет делегат по умолчанию для обработки IControlDesignerView.ViewEvent события. Классы, производные от ControlDesigner , переопределяют OnClick метод для обработки событий, которые возникают, когда пользователь щелкает элемент управления.
Метод OnClick позволяет производным классам обрабатывать событие без присоединения делегата. Это предпочтительная методика обработки событий в производном классе.
Реализация OnClick метода по умолчанию возвращает без выполнения какой-либо обработки.
Примечания для тех, кто наследует этот метод
Переопределите OnClick(DesignerRegionMouseEventArgs) метод в классе, производном от класса , ControlDesigner для обработки событий щелчка во время разработки в элементе управления . Если e значение не равно NULL, в свойстве Region указывается щелкнутая область, если она имеется.
