Метод OLEObjects.Add (Excel)

Добавляет новый объект OLE на лист.

Синтаксис

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

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

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
ClassType	Необязательный	Variant	Необходимо указать ClassType или FileName. Строка, содержащая программный идентификатор создаваемого объекта. Если параметр ClassType указан, параметр FileName и Link игнорируются.
FileName	Необязательный	Variant	Необходимо указать ClassType или FileName. Строка, указывающая файл, который будет использоваться для создания объекта OLE.
Link	Необязательный	Variant	Значение true , чтобы новый объект OLE на основе FileName был связан с этим файлом. Если объект не связан, он создается как копия файла. Значение по умолчанию — False.
DisplayAsIcon	Необязательный	Variant	Значение true для отображения нового объекта OLE в виде значка или обычного изображения. Если этот аргумент имеет значение True, для указания значка можно использовать IconFileName и IconIndex .
IconFileName	Необязательный	Variant	Строка, указывающая файл, содержащий отображаемый значок. Этот аргумент используется только в том случае , если параметр DisplayAsIcon имеет значение True. Если этот аргумент не указан или файл не содержит значков, используется значок по умолчанию для класса OLE.
IconIndex	Необязательный	Variant	Номер значка в файле значка. Используется только в том случае, если параметр DisplayAsIcon имеет значение True , а IconFileName ссылается на допустимый файл, содержащий значки. Если значок с заданным номером индекса не существует в файле, указанном параметром IconFileName, используется первый значок в файле.
IconLabel	Необязательный	Variant	Строка, указывающая метку для отображения под значком. Используется только в том случае , если параметр DisplayAsIcon имеет значение True. Если этот аргумент опущен или является пустой строкой (""), подпись не отображается.
Left	Необязательный	Variant	Начальные координаты нового объекта в точках относительно левого верхнего угла ячейки A1 на листе или в левом верхнем углу диаграммы.
Top	Необязательный	Variant	Начальные координаты нового объекта в точках относительно верхней части строки 1 на листе или верхней части области диаграммы на диаграмме.
Width	Необязательный	Variant	Начальная ширина нового объекта в точках.
Height	Необязательный	Variant	Начальная высота нового объекта в точках.

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

Объект OLEObject , представляющий новый объект OLE.

Пример

В этом примере создается новый объект OLE Microsoft Word на Листе 1.

ActiveWorkbook.Worksheets("Sheet1").OLEObjects.Add _ 
 ClassType:="Word.Document"

В этом примере на лист добавляется кнопка команды.

Worksheets(1).OLEObjects.Add ClassType:="Forms.CommandButton.1", _ 
 Link:=False, DisplayAsIcon:=False, Left:=40, Top:=40, _ 
 Width:=150, Height:=10

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

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