ControlDesigner.OnPaint(PaintEventArgs) Метод

Определение

Вызывается, когда конструктор элементов управления прорисовывает сопоставленный элемент управления в рабочей области конструирования, если значением поля CustomPaint является true.Called when the control designer draws the associated control on the design surface, if the CustomPaint value is true.

protected:
 virtual void OnPaint(System::Windows::Forms::PaintEventArgs ^ e);
protected virtual void OnPaint (System.Windows.Forms.PaintEventArgs e);
abstract member OnPaint : System.Windows.Forms.PaintEventArgs -> unit
override this.OnPaint : System.Windows.Forms.PaintEventArgs -> unit
Protected Overridable Sub OnPaint (e As PaintEventArgs)

Параметры

e
PaintEventArgs

Объект PaintEventArgs, указывающий графику и границы, используемые для прорисовки элемента управления.A PaintEventArgs object that specifies the graphics and rectangle boundaries used to draw the control.

Комментарии

Событие 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.

  • Узел разработки запрашивает разметку HTML для отображения связанного элемента управления в области конструктора.The design host requests HTML markup to render the associated control 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, должны устанавливать ViewFlags.CustomPaint значение и переопределять метод OnPaint для обработки событий, возникающих при отрисовке элементом управления в области конструктора.Classes deriving from ControlDesigner should set the ViewFlags.CustomPaint value and override the OnPaint method to process events that are raised when the design host draws the control on the design surface.

Метод OnPaint позволяет производным классам выполнять обработку события без присоединения делегата.The OnPaint 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.

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

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

Переопределите метод OnPaint(PaintEventArgs) в классе, производном от класса ControlDesigner, чтобы обрабатывать события рисования для элемента управления в области конструктора.Override the OnPaint(PaintEventArgs) method in a class deriving from the ControlDesigner class to handle paint events for a control in the design surface. Однако это событие возникает только в том случае, если CustomPaint значение было задано с помощью метода SetViewFlags(ViewFlags, Boolean).However, the event occurs only if the CustomPaint value has been set with the SetViewFlags(ViewFlags, Boolean) method.

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

Дополнительно