Метод Shapes.AddPicture (Excel)

Создает рисунок из существующего файла. Возвращает объект Shape , представляющий новый рисунок.

Синтаксис

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

выражение: переменная, представляющая объект Shapes.

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
FileName	Обязательный	String	Файл, из которого создается рисунок.
LinkToFile	Обязательный	MsoTriState	Файл, на который необходимо связать ссылку. Используйте msoFalse , чтобы сделать рисунок независимой копией файла. Используйте msoTrue , чтобы связать рисунок с файлом, из которого он был создан.
SaveWithDocument	Обязательный	MsoTriState	Сохранение рисунка вместе с документом. Используйте msoFalse для хранения только сведений о ссылках в документе. Используйте msoTrue , чтобы сохранить связанный рисунок с документом, в который он вставлен. Этот аргумент должен иметь значение msoTrue, если LinkToFile имеет значение msoFalse.
Left	Обязательный	Single	Положение (в точках) левого верхнего угла рисунка относительно левого верхнего угла документа.
Top	Обязательный	Single	Положение (в точках) левого верхнего угла рисунка относительно верхней части документа.
Width	Обязательный	Single	Ширина рисунка в точках (введите -1, чтобы сохранить ширину существующего файла).
Height	Обязательный	Single	Высота рисунка в точках (введите -1, чтобы сохранить высоту существующего файла).

Возвращаемое значение

Shape

Пример

В этом примере изображение, созданное из файла Music.bmp, добавляется в myDocument. Вставленный рисунок связан с файлом, из которого он был создан, и сохраняется с помощью myDocument.

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

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.