.NET Compact Framework のコントロール

更新 : 2007 年 11 月

Windows フォーム アプリケーションの開発用に .NET Compact Framework に用意されているコントロール、コンポーネント、および型の一覧と、それぞれの実装に関する注意事項を次の表に示します。

フォームのコンストラクタではデータおよびコントロールのインスタンスを読み込んだり作成したりできますが、コントロールの配置および他のプロパティの設定が適切に実行されるのは、Load イベント ハンドラです。

コントロールまたはコンポーネント

Pocket PC

Smartphone

備考

Button

あり

なし

カスタム ボタン ントロールの作成については、「カスタム コントロールの開発」を参照してください。

CheckBox

あり

あり

 

Clipboard

あり

あり

サポート : バージョン 2.0

ComboBox

あり

あり

DropDownStyle プロパティの既定値は DropDownList です。

ContextMenu

あり

なし

子フォームに対して作成されたショートカット メニューは、子フォームが破棄されても表示されたままになります。

Control

あり

あり

このコントロールに基づいてカスタム コントロールを作成できます。

CursorCursors

あり

あり

.NET Compact Framework では、CursorWaitCursor、および Default の各カーソルで Current プロパティのみがサポートされます。

DataGrid

あり

あり

.NET Compact Framework の DataGrid クラスは、別のアセンブリ内にあります。これを使用するには、プロジェクトに System.Windows.Forms.DataGrid.dll への参照を追加する必要があります。詳細については、「.NET Compact Framework での DataGrid の使用」を参照してください。

DateTimePicker

あり

あり

このコントロールには Windows Mobile Version 5.0 for Smartphone が必要です。詳細については、「方法 : .NET Compact Framework の DateTimePicker クラスを使用する」を参照してください。

DocumentList

あり

なし

ドキュメントを表示および管理します。方法 : DocumentList コントロールを使用する を参照してください。

このコントロールは、.NET Compact Framework だけで使用できます。

DomainUpDown

あり

あり

.NET Framework とは異なり、Height プロパティでは、コントロールのサイズが変更されます。

このコントロールは、入力の検証を実行しません。

SelectedItemChanged イベントが発生するのは、上向きまたは下向きの矢印をクリックした場合だけです。コントロールにテキストを入力した場合は発生しません。

Form

あり

あり

Pocket PC では、FormBorderStyle プロパティは None 値および FixedSingle 値のみをサポートします。Smartphone では、FormBorderStyleプロパティは使用できません。

.NET Compact Framework はフォームの Icon プロパティをサポートしますが、Pocket PC および Smartphone のアプリケーションにはアイコンを表示しないように設計されています。

HardwareButton

あり

なし

Pocket PC ハードウェアのボタンのオーバーライド機能を提供します。方法 : HardwareButton コンポーネントを使用する を参照してください。

Help

あり

なし

Pocket PC ヘルプで使用する HTML ヘルプ ファイルを表示します。「方法 : ユーザー ヘルプを表示する」を参照してください。

HScrollBar

あり

あり

 

ImageList

あり

あり

 

InputPanel

あり

なし

Pocket PC でソフト入力パネル (SIP: Soft Input Panel) の操作に使用します。「方法 : InputPanel コンポーネントを使用する」を参照してください。

このコントロールは、.NET Compact Framework だけで使用できます。

InputPanel.InputMethodCollection

あり

なし

Pocket PC にインストールされたすべての入力用ソフトウェアにアクセスできます。

このコントロールは、.NET Compact Framework だけで使用できます。

InputMode

なし

あり

方法 : Smartphone の入力モードを設定する を参照してください。

このコントロールは、.NET Compact Framework だけで使用できます。

LinkLabel

あり

なし

自動的に下線が付けられて青色で表示される基本ハイパーリンクだけがサポートされます。

Label

あり

あり

 

ListBoxListControl

あり

あり

リストに項目がない場合は、Text プロパティを設定できません。.NET Framework では、値は保持されますが無視されます。

.NET Compact Framework では、複数の項目を選択することはできません。

コントロールがデータ バインド コントロールの場合のみ、ListControl.SelectedValue プロパティの設定が機能します。

ListView

あり

あり

.NET Compact Framework では、Sort メソッドをサポートしていません。この問題への対処方法については、「方法 : ListView のアイテムを並べ替える」を参照してください。

.NET Compact Framework では、複数の項目を選択することはできません。

LogFont

あり

あり

角度付きのテキストなど、テキスト効果の論理フォント (LogFont) 構造体を定義します。コード例については、「LogFont を使用したテキストの回転のサンプル」を参照してください。

このクラスは、.NET Compact Framework だけで使用できます。

MainMenu

あり

あり

メニューの区分線の位置にはメニュー項目を追加できません。.NET Compact Framework では例外がスローされ、.NET Framework ではこの操作は無視されます。

メニュー項目のテキストにアンパサンド (&) は表示できません。

MessageBox

あり

あり

Windows Mobile for Smartphone では、1 つまたは 2 つのボタンを含むメッセージ ボックスしかサポートしていません。

MessageWindow

あり

あり

Windows メッセージを生成および受信するための機能を提供します。カスタマイズ例については、「方法 : MessageWindow クラスを使用する」を参照してください。

このクラスは、.NET Compact Framework だけで使用できます。

MonthCalendar

あり

あり

 

Notification

あり

なし

ユーザー通知を表示して、その通知に応答します。カスタマイズ例については、「方法 : 通知を送信する」を参照してください。

MobileDevice

あり

あり

このクラスには、Hibernate イベントが用意されています。このイベントはキャッシュされたリソースを解放するために使用できます。

このクラスは、.NET Compact Framework だけで使用できます。

NumericUpDown

あり

あり

.NET Framework とは異なり、Height プロパティでは、コントロールのサイズが変更されます。

.NET Framework とは異なり、このコントロールでは入力の検証は実行されません。ValueChanged イベントが発生するのは、上向きまたは下向きの矢印をクリックした場合だけです。

小数値は整数として扱われます。たとえば、10.25 や 10.75 は切り捨てられて 10 になります。16 ビット符号付き整数を超える値は Pocket PC ではサポートされていません。

Value プロパティを取得するたびに、指定した Increment プロパティ値の倍数が返されます。たとえば、Increment が 3、Minimum が 0、および Maximum が 100 の場合は、上向きの矢印をクリックするたびに、値が 3、6、9、12 と変化します。値が最小または最大に到達すると、必ず最小値または最大値に設定され、それらの値を超えることはありません。値が 100 である場合に下向き矢印をクリックすると、値 97 が得られることが予想されます (100 - 3)。ただし、97 は増分値 3 の倍数ではないため、それよりも小さい 3 の倍数、つまり 96 にコントロールが設定されます。

OpenFileDialog

あり

なし

初期ディレクトリは、My Documents フォルダとそのサブフォルダに制限されています。この制限は、Pocket PC オペレーティング システムによって課せられており、ユーザーが標準ディレクトリ内にファイルを整理する場合に役立ちます。

Panel

あり

あり

 

PictureBox

あり

あり

 

ProgressBar

あり

あり

 

RadioButton

あり

なし

 

SaveFileDialog

あり

なし

 

ScreenOrientation

あり

あり

デバイスをリセットせずに、画面の方向の値を 90、180、または 270 に変更できるようにします。詳細については、「方法 : 画面の向きと解像度を変更する」を参照してください。

このクラスでは、Windows Mobile Version 5.0 for Pocket PC と Windows Mobile Version 5.0 for Smartphone の各ソフトウェアが必要です。このクラスは、.NET Compact Framework だけで使用できます。

Splitter

あり

なし

 

StatusBar

あり

なし

フォームの下部に常にドッキングします。このサイズは変更できません。

TabControl

あり

なし

TabControl は、フォームのクライアント領域を完全に覆うサイズに初期設定されます。サイズを変更するには、コントロールのロックを解除します。

TabPage

あり

なし

 

TextBox

あり

あり

Multiline プロパティで指定された 1 行の TextBox コントロールでは、左寄せのみがサポートされます。Multiline テキスト ボックス コントロールでは、左寄せ、右寄せ、および中央揃えがサポートされます。

Multiline が false の場合、.NET Compact Framework では、コントロールのサイズが Height の指定に合わせられますが、TextBox の 1 行目のみ使用可能です。.NET Framework では、高さが 1 行に保持されます。

PasswordChar プロパティは、指定内容に関係なく常にアスタリスク (*) になります。

Smartphone では、BorderStyle プロパティはサポートされません。

Timer

あり

あり

 

ToolBar

あり

なし

Form では、ToolBar が 1 つだけサポートされます。ToolBar を追加しようとすると、NotSupportedException がスローされます。

ToolBar ボタンの ImageList プロパティを設定する前にその ToolBar ボタンのイメージのインデックスを設定することは、サポートされていません。

TrackBar

あり

なし

 

TreeView

あり

あり

.NET Compact Framework では、TreeViewClick イベントをサポートしていません。代替手段として、AfterSelect イベントを使用できます。ネイティブな TreeView コントロールから機能を取得する方法については、「方法 : ネイティブのコールバックを使用して TreeView をサブクラス化する」を参照してください。

VScrollBar

あり

あり

NumericUpDown コントロールと同様に、設定可能な最大値が最初の空白行のつまみより上にあるため、最大値に設定できません。より具体的には、この値を Maximum - LargeChange + 1 に設定します。

WebBrowser

あり

あり

方法 : .NET Compact Framework で WebBrowser コントロールを使用する を参照してください。

参照

その他の技術情報

.NET Compact Framework の Windows フォーム コントロール