Add メソッド (Microsoft Forms)Add method (Microsoft Forms)

タブまたはページを**TabStrip** または**MultiPage** に追加または挿入するか、コントロールをそのプログラム識別子 (ProgID) でページまたはフォームに追加します。Adds or inserts a Tab or Page in a TabStrip or MultiPage, or adds a control by its programmatic identifier (ProgID) to a page or form.


MultiPage の場合は、TabStrip:For MultiPage, TabStrip:
**設定**オブジェクト = オブジェクト **Set**Object = object. Add ( [ Name [, Caption [, index ]] )Add( [ Name [, Caption [, index ]]] )

その他のコントロールの場合:For other controls:
**設定**コントロール = オブジェクト **Set**Control = object. Add (ProgID [, Name [, Visible ]] )Add(ProgID [, Name [, Visible ]] )

Add メソッドの構文には、次の指定項目があります。The Add method syntax has these parts:

パーツPart 説明Description
objectobject 必ず指定します。Required. 有効なオブジェクト名。A valid object name.
NameName 省略可能です。Optional. 追加するオブジェクトの名前を指定します。Specifies the name of the object being added. 名前を指定しないと、フォームが使用されるアプリケーションのルールに基づいて、既定の名前が生成されます。If a name is not specified, the system generates a default name based on the rules of the application where the form is used.
CaptionCaption 省略可能。Optional. タブまたはコントロールに表示するキャプションを指定します。Specifies the caption to appear on a tab or a control. キャプションを指定しないと、フォームが使用されるアプリケーションのルールに基づいて、既定のキャプションが生成されます。If a caption is not specified, the system generates a default caption based on the rules of the application where the form is used.
indexindex 省略可能。Optional. Pages または Tabs コレクション内でのページまたはタブの位置を示します。Identifies the position of a page or tab within a Pages or Tabs collection. インデックスを指定しないと、ページまたはタブは Pages または Tabs コレクションの最後に追加され、適切なインデックス値が割り当てられます。If an index is not specified, the system appends the page or tab to the end of the Pages or Tabs collection and assigns the appropriate index value.
ProgIDProgID 必須。Required. プログラム識別子。Programmatic identifier. オブジェクトのクラスを示す空白文字を含まないテキスト文字列です。A text string with no spaces that identifies an object class. _ProgID_の標準的な構文はです。.._ProgID_はクラス識別子 (CLSID) にマップされます。The standard syntax for a ProgID is ... A ProgID is mapped to a class identifier (CLSID).
VisibleVisible 省略可能。Optional. オブジェクトが表示される場合は True です (既定値)。True if the object is visible (default). オブジェクトが表示されない場合は False です。False if the object is hidden.


個別のコントロールに対する ProgID__ の値は次のとおりです。ProgID values for individual controls are:

コントロールControl _ProgID_値ProgID value
CheckBoxCheckBox フォームのチェックボックス1Forms.CheckBox.1
ComboBoxComboBox ComboBox. 1Forms.ComboBox.1
CommandButtonCommandButton CommandButtonForms.CommandButton.1
FrameFrame Frame. 1Forms.Frame.1
画質Image 形式1Forms.Image.1
LabelLabel 形式1Forms.Label.1
ListBoxListBox フォームボックス1Forms.ListBox.1
MultiPageMultiPage "MultiPage/フォーム 1"Forms.MultiPage.1
OptionButtonOptionButton オプションボタン1Forms.OptionButton.1
ScrollBarScrollBar ScrollBar. 1Forms.ScrollBar.1
SpinButtonSpinButton (フォーム 1)Forms.SpinButton.1
TabStripTabStrip TabStrip. 1Forms.TabStrip.1
TextBoxTextBox フォームボックス1Forms.TextBox.1
ToggleButtonToggleButton ToggleButton. 1Forms.ToggleButton.1


MultiPage コントロールの場合、Add メソッドは Page オブジェクトを返します。For a MultiPage control, the Add method returns a Page object. TabStrip の場合は、Tab オブジェクトを返します。For a TabStrip, it returns a Tab object. コレクションの最初の Page または Tab のインデックス値は 0、2 番目の Page または Tab の値は 1、などとなります。The index value for the first Page or Tab of a collection is 0, the value for the second Page or Tab is 1, and so on.

オブジェクトの Controls コレクションの場合、Add メソッドは指定した ProgID__ に対応するコントロールを返します。For the Controls collection of an object, the Add method returns a control corresponding to the specified ProgID. コントロールが追加された後で、AddControl イベントが発生します。The AddControl event occurs after the control is added.

ユーザーフォームのControlsコレクションには、デザイン時にコントロールを追加できますが、これを行うには、Microsoft Visual Basic For Applications 拡張ライブラリのDesignerプロパティを使用する必要があります。You can add a control to a user form's Controls collection at design time, but you must use the Designer property of the Microsoft Visual Basic for Applications Extensibility Library to do so. Designerプロパティは、ユーザーフォーム オブジェクトを返します。The Designer property returns the UserForm object.

次の構文では、指定したコントロールの Text プロパティが返されます。The following syntax will return the Text property of the specified control:


実行時にコントロールを追加する場合は、感嘆符構文を使用して、そのコントロールのプロパティを参照する必要があります。If you add a control at run time, you must use the exclamation syntax to reference properties of that control. たとえば、実行時に追加したコントロールの Text プロパティを取得するには、次の構文を使用します。For example, to return the Text property of a control added at run time, use the following syntax:



コントロールの Name プロパティを実行時に変更できるのは、Add メソッドで実行時にそのコントロールを追加した場合だけです。You can change a control's Name property at run time only if you added that control at run time with the Add method.

関連項目See also

サポートとフィードバックSupport and feedback

Office VBA またはこの説明書に関するご質問やフィードバックがありますか?Have questions or feedback about Office VBA or this documentation? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.