Método Shapes.AddOLEObject (Excel)

Artigo
04/07/2023

Cria um objeto OLE. Retorna um objeto Shape representando o novo objeto OLE.

Sintaxe

expressão. AddOLEObject (ClassType, FileName, Link, DisplayAsIcon, IconFileName, IconIndex, IconLabel, Left, Top, Width, Height)

expressão Uma variável que representa um objeto Formas.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
ClassType	Opcional	Variantes	Uma sequência que contém o identificador programático para o objeto a ser criado. Você deve especificar ClassType ou FileName. Se ClassType for especificado, FileName e Link serão ignorados.
FileName	Opcional	Variant	O arquivo a partir do qual o objeto será criado. Se o caminho não for especificado, será utilizada a pasta atual de trabalho. Você deve especificar o argumento ClassType ou FileName para o objeto, mas não ambos.
Link	Opcional	Variant	True para vincular o objeto OLE ao arquivo do qual ele foi criado. False para tornar o uma cópia independente do arquivo de objeto OLE. Se você especificou um valor para ClassType, este argumento deverá ser False. O valor padrão é False.
DisplayAsIcon	Opcional	Variant	True para exibir o objeto OLE como um ícone. O valor padrão é False.
IconFileName	Opcional	Variant	O arquivo que contém o ícone a ser exibido.
IconIndex	Opcional	Variantes	O índice do ícone dentro de IconFileName. A ordem de ícones no arquivo especificado corresponde à ordem na qual os ícones aparecem na caixa de diálogo Alterar ícone (acessada a partir da caixa de diálogo Objeto quando a caixa de diálogo Exibir como ícone é selecionada). O primeiro ícone no arquivo possui o número de índice 0 (zero). Se um ícone com o número de índice fornecido não existir no IconFileName, o ícone com o número de índice 1 (o segundo ícone no arquivo) será usado. O valor padrão é 0 (zero).
IconLabel	Opcional	Variant	Um nome (legenda) a ser exibido abaixo do ícone.
Left	Opcional	Variantes	A posição (em pontos) do canto superior esquerdo do novo objeto em relação ao canto superior esquerdo do documento. O valor padrão é 0 (zero).
Top	Opcional	Variantes	A posição (em pontos) do canto superior esquerdo do novo objeto em relação à parte superior do documento. O valor padrão é 0 (zero).
Width	Opcional	Variantes	As dimensões iniciais do objeto OLE, em pontos.
Height	Opcional	Variantes	As dimensões iniciais do objeto OLE, em pontos.

Valor de retorno

Formato

Exemplo

Este exemplo adiciona um documento do Word vinculado a myDocument.

Set myDocument = Worksheets(1) 
myDocument.Shapes.AddOLEObject Left:=100, Top:=100, _ 
 Width:=200, Height:=300, _ 
 FileName:="c:\my documents\testing.doc", link:=True

Este exemplo adiciona um novo botão de comando a myDocument.

Set myDocument = Worksheets(1) 
myDocument.Shapes.AddOLEObject Left:=100, Top:=100, _ 
 Width:=100, Height:=200, _ 
 ClassType:="Forms.CommandButton.1"

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.