ControlDesigner.OnPaint(PaintEventArgs) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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)
パラメーター
コントロールの描画に使用するグラフィックスと四角形の境界を指定する PaintEventArgs オブジェクト。
注釈
ViewEvent イベントは、デザイン サーフェイス内のコントロールに対する特定のアクションに対して、デザイン ホストによって発生します。 たとえば、次の条件に対してイベントが発生します。
ユーザーがコントロールをクリックします。
デザイン ホストは、関連付けられたコントロールをデザイン サーフェイスにレンダリングするように HTML マークアップを要求します。
ユーザーは、コントロールのテンプレート編集モードに入るか終了します。
ControlDesigner クラスは、IControlDesignerView.ViewEvent イベントを処理する既定のデリゲートを提供します。 ControlDesignerから派生するクラスは、ViewFlags.CustomPaint値を設定し、デザイン ホストがデザイン サーフェイスにコントロールを描画したときに発生するイベントを処理するために、OnPaint メソッドをオーバーライドする必要があります。
OnPaint メソッドを使用すると、派生クラスはデリゲートをアタッチせずにイベントを処理できます。 これは、派生クラスでイベントを処理するために推奨される手法です。
OnPaint メソッドの既定の実装では、処理を実行せずに戻ります。
注意 (継承者)
デザインサーフェイスでコントロールのペイント イベントを処理するには、OnPaint(PaintEventArgs) クラスから派生するクラスのControlDesigner メソッドをオーバーライドします。 ただし、イベントは、 CustomPaint 値が SetViewFlags(ViewFlags, Boolean) メソッドで設定されている場合にのみ発生します。