組み込みのオーナー描画サポートを備えたコントロール

[アーティクル]
05/04/2023

Windows フォームのオーナー描画 (カスタム描画とも呼ばれます) は、特定のコントロールの外観を変更するための手法です。

注意

このトピックで使用されている "コントロール" という語は、Control または Component のいずれかから派生したクラスを意味しています。

通常、Windows では、コントロールの外観を決定する BackColor などのプロパティ設定を使用して、描画を自動的に処理しています。オーナー描画では、描画プロセスを引き継いで、プロパティでは設定できない外観の要素を変更できます。たとえば、多くのコントロールでは表示されるテキストの色を設定できますが、1 つの色に制限されます。オーナー描画では、テキストの一部分を黒で表示し、別の部分を赤で表示する、といったことができます。

実際には、オーナー描画はフォームでのグラフィックスの描画に似ています。たとえば、フォームの Paint イベントのハンドラーでグラフィックスメソッドを使用して ListBox コントロールをエミュレートできますが、すべてのユーザー操作を処理するには独自のコードを記述することが必要になります。オーナー描画では、コントロールは独自のコードを使って内容を描画しますが、それ以外については組み込み機能がすべて保持されます。グラフィックスメソッドを使うと、コントロール内の各項目を描画したり、各項目の一部だけカスタマイズして他の部分は既定の外観を使ったりすることができます。

Windows フォームコントロールでのオーナー描画

オーナー描画をサポートしているコントロールでオーナー描画を実行するには、通常、1 つのプロパティを設定し、1 つまたは複数のイベントを処理します。

オーナー描画をサポートしているほとんどのコントロールには、コントロールの描画時に描画関連のイベントが発生するかどうかを示す OwnerDraw または DrawMode プロパティがあります。

OwnerDraw または DrawMode プロパティを持たないコントロールには、自動的に発生する描画イベントを提供する DataGridView コントロールと、独自の描画関連イベントを持つ外部レンダリングクラスを使って描画される ToolStrip コントロールが含まれます。

さまざまな種類の描画イベントがありますが、標準的な描画イベントはコントロール内の 1 つの項目を描画するために発生します。イベントハンドラーは、描画される項目に関する情報と、その描画に使用できるツールを含む、EventArgs オブジェクトを受け取ります。たとえば、このオブジェクトには、通常、その親コレクション内にある項目のインデックス番号、項目の表示境界を示す Rectangle、描画メソッドを呼び出すための Graphics オブジェクトが含まれます。一部のイベントの EventArgs オブジェクトでは、項目に関する追加情報と、背景やフォーカス四角形などの項目の一部分を既定で描画するために呼び出すことができるメソッドが提供されます。

オーナー描画のカスタマイズを含む再利用可能なコントロールを作成するには、オーナー描画をサポートするコントロールクラスから派生する新しいクラスを作成します。描画イベントを処理するのではなく、新しいクラスの適切な On<イベント名> メソッドのオーバーライドにオーナー描画のコードを組み込みます。この場合、コントロールのユーザーがオーナー描画イベントを処理して追加のカスタマイズを提供できるように、基底クラスの On<イベント名> メソッドを呼び出す必要があります。

次の Windows フォームコントロールは、すべてのバージョンの .NET Framework でオーナー描画をサポートします。

次のコントロールは、.NET Framework 2.0 でのみオーナー描画をサポートしています。

次のコントロールはオーナー描画をサポートしており、.NET Framework 2.0 の新機能です。

以下のセクションでは、これらの各コントロールについてさらに詳しく説明します。

ListBox コントロールと ComboBox コントロール

ListBox および ComboBoxコントロールを使用すると、コントロール内の個々のアイテムをすべて 1 つのサイズで、またはそれぞれ異なるサイズで描画できます。

注意

CheckedListBox コントロールは ListBox コントロールから派生されたものですが、オーナー描画はサポートされません。

各アイテムを同じサイズで描画するには、DrawMode プロパティを OwnerDrawFixed に設定し、DrawItem イベントを処理します。

各アイテムをそれぞれ異なるサイズで描画するには、DrawMode プロパティを OwnerDrawVariable に設定し、MeasureItem と DrawItem の両方のイベントを処理します。 MeasureItem イベントを使うと、項目の DrawItem イベントが発生する前に、その項目のサイズを指定できます。