Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 | Variant | Tem de 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 | Variant | Tem de especificar ClassType ou FileName. Uma sequência de caracteres que especifica o arquivo a ser usado para criar o objeto OLE. |
| Link | Opcional | Variant | 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 | Variant | 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 | Variant | 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 | Variant | 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 | Variant | 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 | Variant | As coordenadas iniciais do novo objeto, em pontos, relativamente ao canto superior esquerdo da célula A1 numa folha de cálculo ou ao canto superior esquerdo de um gráfico. |
| Top | Opcional | Variant | As coordenadas iniciais do novo objeto, em pontos, relativamente à parte superior da linha 1 numa folha de cálculo ou à parte superior da área do gráfico num gráfico. |
| Width | Opcional | Variant | A largura inicial do novo objeto, em pontos. |
| Height | Opcional | Variant | 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.