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