Application.CreateControl メソッド (Access)
CreateControl メソッドは、指定した開いているフォームにコントロールを作成します。 たとえば、ユーザーが特定のフォームを簡単に作成できるカスタム ウィザードを構築しているとします。 ウィザードで CreateControl メソッドを使用して、フォームに適切なコントロールを追加します。
構文
式。CreateControl (FormName、 ControlType、 Section、 Parent、 ColumnName、 Left、 Top、 Width、 Height)
expressionApplication オブジェクトを 表す変数。
パラメーター
| 名前 | 必須 / オプション | データ型 | 説明 |
|---|---|---|---|
| FormName | 必須 | String | コントロールを作成するフォームやレポートの名前を指定します。 |
| ControlType | 必須 | AcControlType | 作成するコントロールの種類を表す AcControlType 定数。 |
| Section | オプション | AcSection | 新しいコントロールを含むセクションを識別する AcSection 定数。 |
| Parent | 省略可能 | バリアント型 | 付属するコントロールの親コントロールの名前を指定します。 親コントロールを持たないコントロールの場合は、この引数に長さ 0 の文字列を使用するか、省略します。 |
| ColumnName | 省略可能 | バリアント型 | コントロールがデータ バインド コントロールになる場合にバインドされるフィールドの名前。 |
| 左、上 | オプション | バリアント型 | コントロールの左上隅の座標 (twip 単位)。 |
| Width, Height | 省略可能 | バリアント型 | コントロールの幅と高さを表す数式を、twip 単位で指定します。 |
戻り値
コントロール
注釈
カスタム ウィザードで CreateControl メソッドと CreateReportControl メソッドを使用して、フォームまたはレポートにコントロールを作成します。 どちらのメソッドも Control オブジェクトを返します。
CreateControl メソッドと CreateReportControl メソッドは、それぞれフォーム デザイン ビューまたはレポート デザイン ビューでのみ使用します。
Parent 引数を使用して、メイン コントロールと下位コントロールの間の関係を識別します。 たとえば、テキスト ボックスにラベルを追加する場合に、テキスト ボックスが主 (親) コントロールで、ラベルが従属 (子) コントロールになります。 ラベル コントロールを作成するときに、 その Parent 引数を親コントロールの名前を識別する文字列に設定します。 テキスト ボックスを作成するときに、 Parent 引数を長さ 0 の文字列に設定します。
また、チェック ボックス、オプション ボタン、またはトグル ボタンを作成するときに、 Parent 引数を設定します。 オプション グループは、中に含まれるチェック ボックス、オプション ボタン、またはトグル ボタンの親コントロールになります。 親コントロールを持つことができるのは、ラベル、チェック ボックス、オプション ボタン、およびトグル ボタンのみです。 これらのコントロールは、親コントロールがない場合でも作成できます。
作成するコントロールの種類と、テーブル内のフィールドにバインドするかどうかを指定して、 ColumnName 引数を設定します。 フィールドに連結できるコントロールには、テキスト ボックス、リスト ボックス、コンボ ボックス、オプション グループ、および連結オブジェクト フレームがあります。 また、トグル ボタン、オプション ボタン、およびチェック ボックスは、オプション グループに含まれていない場合にフィールドと連結できます。
ColumnName 引数にフィールドの名前を指定する場合は、そのフィールドにバインドされるコントロールを作成します。 コントロールのすべてのプロパティは、自動的に対応するフィールドのプロパティと同じ内容に設定されます。 たとえば、コントロールの ValidationRule プロパティの値は、フィールドのそのプロパティの値と同じになります。
注:
ウィザードを使ってフォームまたはレポートに新しいコントロールを作成する場合に、フォームまたはレポートはデザイン ビューで開いておく必要があります。
フォームまたはレポートからコントロールを削除するには、 DeleteControl メソッドと DeleteReportControl メソッドを使用します。
例
次の例では、まず Orders テーブルに基づいて新しいフォームを作成します。 次に、 CreateControl メソッドを使用して、フォームにテキスト ボックス コントロールと添付ラベル コントロールを作成します。
Sub NewControls()
Dim frm As Form
Dim ctlLabel As Control, ctlText As Control
Dim intDataX As Integer, intDataY As Integer
Dim intLabelX As Integer, intLabelY As Integer
' Create new form with Orders table as its record source.
Set frm = CreateForm
frm.RecordSource = "Orders"
' Set positioning values for new controls.
intLabelX = 100
intLabelY = 100
intDataX = 1000
intDataY = 100
' Create unbound default-size text box in detail section.
Set ctlText = CreateControl(frm.Name, acTextBox, , "", "", _
intDataX, intDataY)
' Create child label control for text box.
Set ctlLabel = CreateControl(frm.Name, acLabel, , _
ctlText.Name, "NewLabel", intLabelX, intLabelY)
' Restore form.
DoCmd.Restore
End Sub
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。