Shapes.AddPicture メソッド (Excel)

既存のファイルから図オブジェクトを作成します。 新しい図オブジェクトを表す Shape オブジェクトを返します。

構文

AddPicture (FileName, LinkToFile, SaveWithDocument, Left, Top, Width, Height)

表現Shapes オブジェクトを表す変数です。

パラメーター

名前 必須 / オプション データ型 説明
FileName 必須 String 画像の作成元のファイル。
LinkToFile 必須 MsoTriState 図をグラフィック ファイルとリンクするかどうかを指定します。 msoFalse を使用して、画像をファイルの独立したコピーにします。 msoTrue を使用して、画像を作成元のファイルにリンクします。
SaveWithDocument 必須 MsoTriState 文書を保存するときに図も一緒に保存するかどうかを指定します。 リンク情報のみをドキュメントに格納するには、 msoFalse を使用します。 msoTrue を使用して、リンクされた画像を挿入するドキュメントに保存します。 もし LinkToFilemsoFalseの場合は、この引数を msoTrue に設定する必要があります。
Left 必須 Single 文書の左上隅に対する図の左上隅の位置 ( ポイント単位)。
Top 必須 単精度浮動小数点型 (Single) 文書の上端を基準にして図の左上隅の位置をポイント単位で指定します。
Width 必須 単精度浮動小数点型 (Single) ポイント単位での図の幅 (既存ファイルの幅を保持する場合は、-1 を入力してください)。
Height 必須 単精度浮動小数点型 (Single) ポイント単位での図の高さ (既存ファイルの高さを保持する場合は、-1 を入力してください)。

戻り値

Shape

この例では、ファイルから作成した画像 Music.bmp myDocument に追加します。 挿入された画像は、その画像の作成元のファイルにリンクされ、 myDoc と共に保存されます。

Set myDocument = Worksheets(1) 
myDocument.Shapes.AddPicture _ 
    "c:\microsoft office\clipart\music.bmp", _ 
    True, True, 100, 100, 70, 70

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

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