ユーザー コントロールのカスタム描画のサンプル
更新 : 2007 年 11 月
このサンプルでは、カスタム描画のユーザー コントロールを作成および使用する方法の例を示します。
サンプルとそのインストール手順を取得するには
次のいずれかを実行します。
[ヘルプ] メニューの [サンプル] をクリックします。
サンプルの情報を示す Readme が表示されます。
Visual Studio 2008 のサンプルの Web サイトにアクセスします。ここには、サンプルの最新版が掲載されています。
Visual Studio をインストールしたコンピュータで、サンプルを検索します。既定では、サンプルおよび Readme ファイルは drive:\Program Files\Microsoft Visual Studio 9.0\Samples\lcid にインストールされています。Visual Studio の Express Edition については、すべてのサンプルがオンラインで提供されています。
詳細については、「サンプル ファイルの格納場所」を参照してください。
.gif "セキュリティに関するメモ") セキュリティに関するメモ : |
|---|
このサンプル コードは概念を示すためのものであり、その概念に関連するコードのみを示しています。特定の環境について必ずしもセキュリティ要件を満たしていませんので、そのまま使用しないでください。セキュリティおよびエラー処理コードを追加して、プロジェクトをより安全かつ堅牢にすることをお勧めします。これらのサンプル コードは、現状有姿のままで提供されるものであり、一切保証されていません。 |
このサンプルを実行するには
- F5 キーを押します。
使用例
このサンプルでは、カスタム描画のユーザー コントロールを作成する方法、フォームで使用する方法、イベントに応答させる方法、およびデザイナで使用するプロパティを定義する方法の例を示します。作成するのは、スコア記録のコントロールです。1 つはデジタル スコアボードで、数値をデジタル形式で表示します。もう 1 つはビーズ式のスコアボードで、ビーズを前後にスライドさせてスコアを追跡します。いずれも、さまざまなイベントに応答し、またデザイン時に利用できるプロパティが多数あります。
カスタム描画 このサンプルのカスタム コントロールはいずれも、UserControl クラスを継承して OnPaint をオーバーライドする方法の例を示しています。カスタム描画のユーザー コントロールは、UserControl を継承します。カスタム描画は、コントロールの OnPaint メソッドをオーバーライドすることにより実行します。OnPaint メソッドには PaintEventArgs 引数があり、クリップ四角形 (Rectangle) とグラフィックス オブジェクト (Graphics) をそこから取得します。
カスタム コントロール イベント カスタム コントロールでは、通常のコントロールが応答するのと同じイベントに応答できます。これは、UserControl クラス内でイベント ハンドラ メソッドをオーバーライドすることによって行われます。このサンプルのカスタム コントロールはいずれも、MouseUp や Click などのさまざまなイベントに応答する方法の例を示しています。
プロパティ 通常は、Visual Studio を使用してデザイン時に編集できるコントロールについては、プロパティを作成することが望まれます。このサンプルのカスタム コントロールはいずれも、Visual Studio の [プロパティ] ウィンドウに表示される Public プロパティを作成する方法の例を示しています。