Add メソッド (Microsoft Forms)
TabStrip または MultiPage に Tab または Page を追加または挿入するか、プログラム識別子 (ProgID) によるコントロールをページまたはフォームに追加します。
構文
MultiPage の場合、TabStrip:
オブジェクト オブジェクトを設定します = 。 Add( [ Name [, Caption [, index ]]] )
その他のコントロールの場合:
Control オブジェクトを = 設定します。 Add(ProgID [, Name [, Visible ]] )
Add メソッドの構文には、次の指定項目があります。
| パーツ | 説明 |
|---|---|
| object | 必須。 有効なオブジェクト名。 |
| Name | 省略可能。 追加するオブジェクトの名前を指定します。 名前を指定しないと、フォームが使用されるアプリケーションのルールに基づいて、既定の名前が生成されます。 |
| Caption | 省略可能。 タブまたはコントロールに表示するキャプションを指定します。 キャプションを指定しないと、フォームが使用されるアプリケーションのルールに基づいて、既定のキャプションが生成されます。 |
| index | オプション。 Pages または Tabs コレクション内でのページまたはタブの位置を示します。 インデックスを指定しないと、ページまたはタブは Pages または Tabs コレクションの最後に追加され、適切なインデックス値が割り当てられます。 |
| ProgID | 必須です。 プログラム識別子。 オブジェクトのクラスを示す空白文字を含まないテキスト文字列です。 ProgID の標準構文は Vendor> です<。<コンポーネント>。<バージョン>。 ProgID はクラス識別子 (CLSID) にマップされます。 |
| Visible | 省略可能。 オブジェクトが表示される場合は True です (既定値)。 オブジェクトが表示されない場合は False です。 |
Settings
個別のコントロールに対する ProgID の値は次のとおりです。
| コントロール | ProgID 値 |
|---|---|
| CheckBox | Forms.CheckBox.1 |
| ComboBox | Forms.ComboBox.1 |
| CommandButton | Forms.CommandButton.1 |
| Frame | Forms.Frame.1 |
| イメージ | Forms.Image.1 |
| Label | Forms.Label.1 |
| ListBox | Forms.ListBox.1 |
| MultiPage | Forms.MultiPage.1 |
| OptionButton | Forms.OptionButton.1 |
| ScrollBar | Forms.ScrollBar.1 |
| SpinButton | Forms.SpinButton.1 |
| TabStrip | Forms.TabStrip.1 |
| TextBox | Forms.TextBox.1 |
| ToggleButton | Forms.ToggleButton.1 |
注釈
MultiPage コントロールの場合、Add メソッドは Page オブジェクトを返します。 TabStrip の場合は、Tab オブジェクトを返します。 コレクションの最初の Page または Tab のインデックス値は 0、2 番目の Page または Tab の値は 1、などとなります。
オブジェクトの Controls コレクションの場合、Add メソッドは指定した ProgID に対応するコントロールを返します。 コントロールが追加された後で、AddControl イベントが発生します。
コントロールはデザイン時にユーザー フォームの Controls コレクションに追加できますが、そのためには Microsoft Visual Basic for Applications機能拡張ライブラリの Designer プロパティを使用する必要があります。 Designer プロパティは UserForm オブジェクトを返します。
次の構文では、指定したコントロールの Text プロパティが返されます。
userform1.thebox.text
実行時にコントロールを追加する場合は、感嘆符構文を使用して、そのコントロールのプロパティを参照する必要があります。 たとえば、実行時に追加したコントロールの Text プロパティを取得するには、次の構文を使用します。
userform1!thebox.text
注:
コントロールの Name プロパティを実行時に変更できるのは、Add メソッドで実行時にそのコントロールを追加した場合だけです。
関連項目
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。