OLEObjects.Add メソッド (Excel)

ワークシートに新しい OLE オブジェクトを追加します。

構文

式。Add (ClassType、 FileName、 Link、 DisplayAsIcon、 IconFileName、 IconIndex、 IconLabel、 Left、 Top、 Width、 Height)

式OLEObjects オブジェクトを表す変数。

パラメーター

名前	必須 / オプション	データ型	説明
ClassType	省略可能	バリアント型	ClassType または FileName を指定する必要があります。 オブジェクトを作成するためのプログラム ID を含む文字列を指定します。 ClassType が指定されている場合、FileName と Link は無視されます。
FileName	省略可能	バリアント型	ClassType または FileName を指定する必要があります。 OLE オブジェクトの作成に使用するファイルを示す文字列を指定します。
Link	省略可能	バリアント型 (Variant)	この引数に True を指定すると、引数 FileName で指定したファイルで作成された新しい OLE オブジェクトをリンクします。 オブジェクトをリンクしない場合は、オブジェクトはそのファイルのコピーとして作成されます。 既定値は、 False です。
DisplayAsIcon	省略可能	バリアント型 (Variant)	新しい OLE オブジェクトをアイコンまたは通常のピクチャで表示するには、 True を指定します。 この引数が True の場合、引数 IconFileName および引数 IconIndex を使ってアイコンを指定できます。
IconFileName	省略可能	バリアント型 (Variant)	表示するアイコンのファイルを示す文字列を指定します。 この引数は、 DisplayAsIcon が True の場合にのみ使用されます。 この引数を省略するか、指定したファイルにアイコンがない場合は、OLE クラスの既定のアイコンが使われます。
IconIndex	省略可能	バリアント型 (Variant)	アイコン ファイルに含まれるアイコンの番号を指定します。 これは、 DisplayAsIcon が True で 、 IconFileName がアイコンを含む有効なファイルを参照している場合にのみ使用されます。 この引数で指定したインデックス番号のアイコンが、引数 IconFileName で指定したファイルに存在しないときは、ファイル内の最初のアイコンが使われます。
IconLabel	省略可能	バリアント型 (Variant)	アイコンの下に表示するタイトルを示す文字列を指定します。 これは、 DisplayAsIcon が True の場合にのみ使用されます。 この引数を省略するか空の文字列 ("") を指定すると、タイトルは表示されません。
Left	省略可能	バリアント型	ワークシート上のセル A1 の左上隅またはグラフの左上隅を基準とした、新しいオブジェクトの初期座標を ポイント単位で指定します。
Top	省略可能	バリアント型	ワークシート上の行 1 の上端、またはグラフのグラフ領域の上部を基準に、新しいオブジェクトの初期座標をポイント単位で指定します。
Width	オプション	バリアント型	新しいオブジェクトの初期幅をポイント単位で指定します。
Height	オプション	バリアント型	新しいオブジェクトの初期高さ (ポイント単位)。

戻り値

新しい OLE オブジェクトを表す OLEObject オブジェクト。

例

次の使用例は、シート 1 に新しい Word OLE オブジェクトを作成します。

ActiveWorkbook.Worksheets("Sheet1").OLEObjects.Add _ 
 ClassType:="Word.Document"

次の使用例はワークシート 1 にコマンド ボタンを追加します。

Worksheets(1).OLEObjects.Add ClassType:="Forms.CommandButton.1", _ 
 Link:=False, DisplayAsIcon:=False, Left:=40, Top:=40, _ 
 Width:=150, Height:=10

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。