カスタムコントロールの開発

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

.NET Compact Framework では、ほとんどのデバイスプロジェクトの要件を満たす Windows フォームコントロールが用意されています。これらのコントロールは、限られたリソースを有効に使用するようにデザインされています。このため、継承されるすべてのプロパティ、メソッド、およびイベントはサポートされません。サポートされない機能については、コモンコントロールから独自のカスタムコントロールを派生できます。カスタムコントロールは、Control クラスまたはアセンブリ内の既存の UserControl から継承するパブリック型を定義することにより作成できます。

コントロールの最も簡単なカスタマイズ方法は、コモンコントロールのメソッドをオーバーライドすることです。たとえば、TextBox コントロールの継承された OnKeyPress メソッドをオーバーライドして、入力を数字だけに制限するコードを作成できます。

メモ :
.NET Compact Framework では、基本コントロールから継承される、Windows フォームコントロールのすべてのプロパティ、メソッド、およびイベントがサポートされているとは限りません。

コモンコントロールから派生する方法は、次のとおりです。

コモンコントロールで独自のプロパティ、メソッド、およびイベントをオーバーライドする。
コントロールに対して別のプロパティ、メソッド、およびイベントを定義する。
TextBox コントロールと Button コントロールのコレクションなど、複合コントロールを構築する。
数値データだけを受け入れる TextBox など、ユーザーの操作にコントロールが応答する方法を定義する。

現在、.NET Compact Framework では、デザイン時に使用できるカスタムコントロールを追加する機能は用意されていません。

さらに複雑なカスタマイズが必要な場合は、Controlクラスから派生するカスタムコントロールを作成する必要があります。OnPaint メソッドをオーバーライドしてコントロールを描画し、さらに必要に応じてカスタムイベントなどの UI 以外のコントロールを作成できます。

基本の Control クラスは、派生するコントロールの描画方法については認識せず、OnPaint メソッドでは描画ロジックを提供しません。Control の OnPaint メソッドは、Paint イベントを登録イベントレシーバへディスパッチします。

.NET Compact Framework は、Form クラスおよび Control クラスに対してのみ Paint イベントおよび Resize イベントを起動します。

ツールボックスへのカスタムコントロールの追加

Microsoft Visual Studio 2005 でカスタムコントロールのプロジェクトを作成する場合は、アプリケーションのコンパイル時にカスタムコントロールがツールボックスに自動的に追加されます。次のいずれかの種類のプロジェクトを使用してカスタムコントロールを作成できます。

コントロールライブラリ
クラスライブラリ
クラスライブラリ (1.0)

ツールボックスにカスタムコントロールを追加するには、[ツール] メニューの [ツールボックスアイテムの選択] をクリックします。次に、コントロールのアセンブリを参照します。

カスタムコントロールの手法と考慮事項

カスタムコントロールを作成する場合は、次の点に注意してください。

NET フレームワークでは一部のコントロールで親コントロールから値を継承できますが、.NET Compact Framework では親コントロールからの値の継承がサポートされません。この問題を回避するために、OnParentChanged メソッドを使用して親コントロールが変更されたことを把握すると共に、適切な処置を講じます。次のコード例は、親コントロールの背景色が変更されたときに背景色を変更する方法を示しています。
```
protected override void OnParentChanged(EventArgs e)
{
    base.OnParentChanged(e);
    this.BackColor = Parent.BackColor;
}
```
```
Protected Overrides Sub OnParentChanged(ByVal e As EventArgs) 
    MyBase.OnParentChanged(e)
    Me.BackColor = Parent.BackColor
End Sub
```
.NET Compact Framework では、親コントロールのフォントの継承がサポートされていません。
ショートカットメニューを表示する "タップアンドホールド" イベントが発生した場所をカスタムコントロール上で検出するには、Popup イベントを処理し、MousePosition を使用して現在のマウスの座標を確認します。
Tab キーを使用してカスタムコントロールから以前のコントロールに移動するには、Up キーの検出時に KeyDown イベントハンドラ内で次のコードを使用します。
```
this.Parent.Controls(
    this.Parent.GetChildIndex(customcontrol) - 1).Focus()
```
```
Me.Parent.Controls( _
    Me.Parent.GetChildIndex(customcontrol) - 1).Focus
```