OLEObjects.Add メソッド (Excel)

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

構文

Add (ClassType, FileName, Link, DisplayAsIcon, IconFileName, IconIndex, IconLabel, Left, Top, Width, Height)

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

パラメーター

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

戻り値

しい 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 のサポートおよびフィードバックを参照してください。