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