Método Shapes.AddOLEObject (Excel)
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.