Método OLEObjects.Add (Excel)
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.