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.
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 | Variant | Uma sequência que contém o identificador programático para o objeto a ser criado. Tem de 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. Tem de 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 | Variant | 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 não existir um ícone com o número de índice especificado em IconFileName, é utilizado o ícone com o número de índice 1 (o segundo ícone no ficheiro). O valor padrão é 0 (zero). |
| IconLabel | Opcional | Variant | Um nome (legenda) a ser exibido abaixo do ícone. |
| Left | Opcional | Variant | 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 | Variant | 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 | Variant | As dimensões iniciais do objeto OLE, em pontos. |
| Height | Opcional | Variant | 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.