ControlDesigner.OnPaint(PaintEventArgs) メソッド

定義

CustomPaint値が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 オブジェクト。

注釈

ViewEvent イベントは、デザイン サーフェイス内のコントロールに対する特定のアクションに対して、デザイン ホストによって発生します。 たとえば、次の条件に対してイベントが発生します。

  • ユーザーがコントロールをクリックします。

  • デザイン ホストは、関連付けられたコントロールをデザイン サーフェイスにレンダリングするように HTML マークアップを要求します。

  • ユーザーは、コントロールのテンプレート編集モードに入るか終了します。

ControlDesigner クラスは、IControlDesignerView.ViewEvent イベントを処理する既定のデリゲートを提供します。 ControlDesignerから派生するクラスは、ViewFlags.CustomPaint値を設定し、デザイン ホストがデザイン サーフェイスにコントロールを描画したときに発生するイベントを処理するために、OnPaint メソッドをオーバーライドする必要があります。

OnPaint メソッドを使用すると、派生クラスはデリゲートをアタッチせずにイベントを処理できます。 これは、派生クラスでイベントを処理するために推奨される手法です。

OnPaint メソッドの既定の実装では、処理を実行せずに戻ります。

注意 (継承者)

デザインサーフェイスでコントロールのペイント イベントを処理するには、OnPaint(PaintEventArgs) クラスから派生するクラスのControlDesigner メソッドをオーバーライドします。 ただし、イベントは、 CustomPaint 値が SetViewFlags(ViewFlags, Boolean) メソッドで設定されている場合にのみ発生します。

適用対象

こちらもご覧ください