DoCmd.OpenForm(フォームを開く) [マクロ（DoCmd）編]

VBAでフォームを開く

VBAでフォームを開くにはDoCmd.OpenFormを使います。

サンプルダウンロード

DoCmd.OpenFormの使い方

　DoCmd.OpenFormは、指定したフォームを指定したビューで開くメソッドです。単にフォームを開くだけでなく、「レコードの抽出条件を指定して開く（フィルタ機能）」、「簡単なデータを渡す（OpenArgs）」など、オプションの指定方法によってフォームを開くときにいろいろな操作が行えます。

図 1DoCmd.OpenFormの書式

DoCmd.OpenForm FormName, View, FilterName, WhereCondition, DataMode, WindowMode, OpenArgs

フォームを開きます

◆引数
・FormName（フォーム名）
　開くフォームの名前を文字列で指定します。指定できるのは、カレントデータベースのフォームのみです。

・View（フォームのビュー）省略可能
　フォームを開くときのビューを、表1の内容で指定します。このオプションを省略したときは、acNormalが適用されます。

・FilterName（フィルタ名）省略可能
　レコードソースに使用するクエリの名前を文字列で指定します。指定できるのは、カレントデータベースのクエリのみです。

・WhereCondition（抽出条件）省略可能
　レコードの抽出条件を記述します。抽出条件の書式は、フォームのフィルタに指定する内容と同じです。

・DataMode（データ入力モード）省略可能
　データ入力モードを表2の内容で指定します。ただし、適用されるのはフォームビューかデータシートビューで開かれているフォームに対してのみです。
　このオプションを省略したときは、acFormPropertySettingsが適用されます。

・WindowMode（ウィンドウモード）省略可能
　フォームを開くときのウィンドウの形式を表3の内容で指定します。省略時は通常のウィンドウ（acWindowNormal）で開きます。

・OpenArgs（受け渡しデータ）省略可能
　開いたフォームに渡すデータを指定します。この引数に指定できるデータは、数値や文字列などの簡単なデータです。

◆Tips
・OpenArgs引数に渡したデータは、開いたフォームのOpenArgsプロパティで参照できます。
・WhereConditionに記述する条件式の書き方については、「フォームでレコードの検索や絞り込みを行う」などを参照してください。

【記述例】
フォーム「住所一覧」を開きます。

DoCmd.OpenForm "住所一覧", acNormal

表 1Viewに指定する内容（AcFormView列挙）

名前	値	内容
acDesign	1	デザインビューでフォームを開きます。
acFormDS	3	データシートビューでフォームを開きます。
acFormPivotChart	5	ピボットグラフビューでフォームを開きます。
acFormPivotTable	4	ピボットテーブルビューでフォームを開きます。
acLayout	6	レイアウトビューでフォームを開きます。
acNormal	0	【既定値】フォームビューでフォームを開きます。
acPreview	2	印刷プレビューでフォームを開きます。

注）この表の内容は、情報の正確性を期するためAccessヘルプから引用しています。

表 2DataModeに指定する内容（AcFormOpenDataMode列挙）

名前	値	内容
acFormAdd	0	ユーザーは新しいレコードを追加できますが、既存のレコードを編集できません。
acFormEdit	1	ユーザーは既存のレコードを編集したり、新しいレコードを追加したりできます。
acFormPropertySettings	-1	【既定値】ユーザーはフォームのプロパティのみ変更できます。
acFormReadOnly	2	ユーザーはレコードの参照のみ可能です。

注）この表の内容は、情報の正確性を期するためAccessヘルプから引用しています。

表 3WindowModeに指定する内容（AcWindowMode列挙）

名前	値	内容
acDialog	3	フォームやレポートの "Modal/作業ウィンドウ固定" プロパティと "PopUp/ポップアップ" プロパティが [Yes/はい] に設定されます。
acHidden	1	フォームやレポートが非表示になります。
acIcon	2	フォームやレポートが最小化され、Windows タスクバーに収まります。
acWindowNormal	0	【既定値】フォームやレポートは、そのプロパティで設定されたモードで開きます。

注）この表の内容は、情報の正確性を期するためAccessヘルプから引用しています。

DoCmd.OpenFormの使用例

　次のリストは、DoCmd.OpenForm で指定したフォームを開くプログラムの作成例です。プロシージャ「btnSubmit_Click」は、フォームに配置した「データ一覧起動」ボタンのイベントプロシージャ「クリック時」です。

　このサンプルは、メニューフォーム用のフォームから個々の機能を呼び出す仕組みの簡単な例です。ボタンをクリックしたときのイベントプロシージャでDoCmd.OpenFormを実行し（6行目）、データ一覧を表示するフォーム「データ一覧」を開きます。

リスト 1DoCmd.OpenFormでフォームを開くプログラム

1
2
3
4
5
6
7
8