Método OLEObjects.Add (Excel)

  • Artigo

Adiciona um novo objeto OLE a uma planilha.

Sintaxe

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

Expressão Uma variável que representa um objeto OLEObjects .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
ClassType Opcional Variantes Você deve especificar ClassType ou FileName. Uma sequência que contém o identificador programático para o objeto a ser criado. Se ClassType for especificado, FileName e Link serão ignorados.
FileName Opcional Variantes Você deve especificar ClassType ou FileName. Uma sequência de caracteres que especifica o arquivo a ser usado para criar o objeto OLE.
Link Opcional Variantes True para que o novo objeto OLE baseado em FileName seja vinculado a esse arquivo. Se o objeto não estiver vinculado, ele será criado como uma cópia do arquivo. O valor padrão é False.
DisplayAsIcon Opcional Variantes True para exibir o novo objeto OLE como um ícone ou como sua imagem comum. Se este argumento for True, IconFileName e IconIndex poderão ser usados para especificar um ícone.
IconFileName Opcional Variantes Uma sequência de caracteres que especifica o arquivo que contém o ícone a ser exibido. Será usado somente se DisplayAsIcon for True. Se esse argumento não for especificado ou se o arquivo não contiver ícones, será usado o ícone padrão para a classe OLE.
IconIndex Opcional Variantes O número do ícone no arquivo de ícone. Será usado somente se DisplayAsIcon for True e IconFileName se referir a um arquivo válido que contenha ícones. Se um ícone com o número de índice determinado não existir no arquivo especificado por IconFileName, será usado o primeiro ícone do arquivo.
IconLabel Opcional Variantes Uma sequência de caracteres que especifica um rótulo a ser exibido abaixo do ícone. Será usado somente se DisplayAsIcon for True. Se esse argumento for omitido ou for uma sequência de caracteres vazia (""), nenhuma legenda será exibida.
Left Opcional Variantes As coordenadas iniciais do novo objeto, em pontos, relativas ao canto superior esquerdo da célula A1 em uma planilha ou ao canto superior esquerdo de um gráfico.
Top Opcional Variantes As coordenadas iniciais do novo objeto, em pontos, relativas à parte superior da linha 1 em uma planilha ou à parte superior da área do gráfico em um gráfico.
Width Opcional Variantes A largura inicial do novo objeto, em pontos.
Height Opcional Variantes A altura inicial do novo objeto, em pontos.

Valor de retorno

Um objeto OLEObject que representa o novo objeto OLE.

Exemplo

Este exemplo cria um novo objeto OLE do Microsoft Word em Sheet1.

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

Este exemplo adiciona um botão de comando à planilha um.

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

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.