ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Метод

Определение

Вызывается основным приложением разработки, когда пользователь во время разработки щелкает сопоставленный элемент управления.Called by the design host when the user clicks the associated control at design time.

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)

Параметры

e
DesignerRegionMouseEventArgs

Объект DesignerRegionMouseEventArgs, указывающий расположение и, возможно, область конструктора элементов управления, где пользователь выполняет щелчок.A DesignerRegionMouseEventArgs object that specifies the location and, possibly, the control designer region that the user clicked.

Примеры

В следующем примере кода показано, как использовать обработчик для OnClick события в управляемой области элемента управления и использовать DesignerRegionMouseEventArgs объект для указания области, на которую осуществляется щелчок.The following code example shows how to use a handler for the OnClick event in a clickable region of the control and use a DesignerRegionMouseEventArgs object to identify the region that is being clicked.

Этот пример кода является частью более крупного примера кода для EditableDesignerRegion класса.This code example is part of a larger code example for the EditableDesignerRegion class.

// 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Событие вызывается узлом разработки для определенных действий с элементом управления в области конструктора.The ViewEvent event is raised by the design host for certain actions on a control in the design surface. Например, событие вызывается для следующих условий:For example, an event is raised for the following conditions:

  • Пользователь щелкает элемент управления.The user clicks the control.

  • Конструктор элементов управления закрашивает область конструктора.The control designer paints on the design surface.

  • Пользователь вводит или выходит из режима редактирования шаблона для элемента управления.The user enters or exits template editing mode for the control.

ControlDesignerКласс предоставляет делегат по умолчанию для обработчика IControlDesignerView.ViewEvent события.The ControlDesigner class supplies a default delegate to handle the IControlDesignerView.ViewEvent event. Классы, производные от ControlDesigner переопределения OnClick метода для обработки событий, возникающих, когда пользователь щелкает элемент управления.Classes deriving from ControlDesigner override the OnClick method to process events that are raised when the user clicks a control.

OnClickМетод позволяет производным классам выполнять обработку события без присоединения делегата.The OnClick method allows derived classes to handle the event without attaching a delegate. Это предпочтительная методика обработки событий в производном классе.This is the preferred technique for handling the event in a derived class.

Реализация метода по умолчанию OnClick возвращает без выполнения какой бы то ни было обработки.The default implementation of the OnClick method returns without performing any processing.

Примечания для тех, кто наследует этот метод

Переопределите OnClick(DesignerRegionMouseEventArgs) метод в классе, производном от ControlDesigner класса, чтобы обрабатывались события нажатия кнопки времени разработки в элементе управления.Override the OnClick(DesignerRegionMouseEventArgs) method in a class deriving from the ControlDesigner class to handle design-time click events on the control. Если значение не равно e null, в свойстве задается выбранный регион (если таковой имеется) Region .If e is not null, the clicked region, if any, is specified in the Region property.

Применяется к

См. также раздел