Shapes. AddPicture メソッド (Excel)Shapes.AddPicture method (Excel)

既存のファイルから図オブジェクトを作成します。Creates a picture from an existing file. 新しい図オブジェクトを表す Shape オブジェクトを返します。Returns a Shape object that represents the new picture.

構文Syntax

Addpicture(FileNamelinktofilesavewithdocumentLeftTopWidthHeight)expression.AddPicture (FileName, LinkToFile, SaveWithDocument, Left, Top, Width, Height)

表現 Shapes オブジェクトを表す変数です。expression A variable that represents a Shapes object.

パラメーターParameters

名前Name 必須 / オプションRequired/Optional データ型Data type 説明Description
FileNameFileName StringRequired StringString 図を作成するファイルを指定します。The file from which the picture is to be created.
LinkToFileLinkToFile 必須Required MsoTriStateMsoTriState 図をグラフィック ファイルとリンクするかどうかを指定します。The file to link to. MsoFalseを使用して、画像をファイルの独立したコピーとして作成します。Use msoFalse to make the picture an independent copy of the file. MsoTrueを使用して、図を作成元のファイルにリンクします。Use msoTrue to link the picture to the file from which it was created.
SaveWithDocumentSaveWithDocument 必須Required MsoTriStateMsoTriState 文書を保存するときに図も一緒に保存するかどうかを指定します。To save the picture with the document. ドキュメントにリンク情報のみを格納するには、 msoFalseを使用します。Use msoFalse to store only the link information in the document. MsoTrueを使用して、リンクされた図を挿入先の文書と共に保存します。Use msoTrue to save the linked picture with the document into which it's inserted. もし LinkToFilemsoFalseの場合は、この引数を msoTrue に設定する必要があります。This argument must be msoTrue if LinkToFile is msoFalse.
LeftLeft 必須Required SingleSingle 文書の左上隅を基準にして図の左上隅の位置をポイント単位で指定します。The position (in points) of the upper-left corner of the picture relative to the upper-left corner of the document.
TopTop 必須Required SingleSingle 文書の上端を基準にして図の左上隅の位置をポイント単位で指定します。The position (in points) of the upper-left corner of the picture relative to the top of the document.
WidthWidth 必須Required SingleSingle ポイント単位での図の幅 (既存ファイルの幅を保持する場合は、-1 を入力してください)。The width of the picture, in points (enter -1 to retain the width of the existing file).
HeightHeight 必須Required SingleSingle ポイント単位での図の高さ (既存ファイルの高さを保持する場合は、-1 を入力してください)。The height of the picture, in points (enter -1 to retain the height of the existing file).

戻り値Return value

ShapeShape

Example

次の使用例は、ファイル Music から作成された図を_myDocument_に追加します。This example adds a picture created from the file Music.bmp to myDocument. 挿入された図は、作成元のファイルにリンクされ、 _myDocument_に保存されます。The inserted picture is linked to the file from which it was created and is saved with myDocument.

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

サポートとフィードバック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.