ControlDesigner.OnClick(DesignerRegionMouseEventArgs) Метод

Определение

Пространство имен:

System.Web.UI.Design

Сборка:

System.Design.dll

Вызывается основным приложением разработки, когда пользователь во время разработки щелкает сопоставленный элемент управления.

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, указывающий расположение и, возможно, область конструктора элементов управления, где пользователь выполняет щелчок.

Примеры

В следующем примере кода показано, как использовать обработчик для события в доступной для 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 указывается щелкнутая область, если она имеется.

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

• ViewEventHandler
• DesignerRegionMouseEventArgs
• DesignerRegion
• Общие сведения о конструкторах элементов управления ASP.NET