ControlDesigner.OnPaint メソッド

.NET Framework クラス ライブラリ リファレンス

ControlDesigner.OnPaint メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

CustomPaint 値が true の場合に、コントロール デザイナが関連付けられているコントロールをデザイン サーフェイスに描画すると呼び出されます。

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Sub
 OnPaint ( _
    e As PaintEventArgs _
)

Visual Basic (使用法)

Dim e As PaintEventArgs

Me.OnPaint(e)

C#

protected virtual void OnPaint (
    PaintEventArgs e
)

C++

protected:
virtual void OnPaint (
    PaintEventArgs^ e
)

J#

protected void OnPaint (
    PaintEventArgs e
)

JScript

protected function OnPaint (
    e : PaintEventArgs
)

パラメータ

e

コントロールの描画に使用するグラフィックスと四角形の境界を指定する PaintEventArgs。

解説

ViewEvent イベントは、デザイン サーフェイスのコントロールの特定の操作に対して発生し、デザイン ホストによって生成されます。たとえば、イベントは、次の状況で生成されます。

• ユーザーがコントロールをクリックしたとき。

• デザイン ホストが、関連付けられているコントロールをデザイン サーフェイスに表示するための HTML マークアップを要求したとき。

• ユーザーがコントロールのテンプレート編集モードに切り替えたとき、またはテンプレート編集モードを終了したとき。

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

OnPaint メソッドを使用すると、デリゲートを結び付けずに派生クラスでイベントを処理できます。派生クラスでイベントを処理する場合は、この手法をお勧めします。

OnPaint メソッドの既定の実装では、処理が行われずに制御が戻ります。

継承時の注意 ControlDesigner クラスから派生したクラスの OnPaint メソッドをオーバーライドして、デザイン サーフェイスでの描画イベントを処理します。ただし、このイベントは、SetViewFlags メソッドで CustomPaint 値が設定されている場合にだけ発生します。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ControlDesigner クラス
ControlDesigner メンバ
System.Web.UI.Design 名前空間
CustomPaint
SetViewFlags
ViewEventHandler
IControlDesignerView
その他の技術情報
Web フォームのデザイン時サポート