Objeto OLEObjects (Excel)

  • Artigo

Uma coleção de todos os objetos OLEObject na planilha especificada.

Comentários

Cada objeto OLEObject representa um controle ActiveX ou um objeto OLE vinculado ou inserido.

Um controle ActiveX em uma planilha tem dois nomes: o nome da forma que contém o controle que você pode ver na caixa Name ao exibir a planilha e o nome de código para o controle, que pode ser visto na célula à direita do (Name) na janela de propriedades.

Quando você adiciona um controle em uma planilha pela primeira vez, nome da forma e nome do código correspondem. Entretanto, se você alterar o nome da forma ou o nome do código, o outro não será alterado automaticamente para que fiquem correspondentes novamente. Este último, no entanto, parece ter sido alterado com versões do Excel. Com a versão 16.0, ambos são mantidos consistentes e não é possível alterar um dos dois sozinho.

Exemplo

Use o método OLEObjects do objeto Worksheet para retornar a coleção OLEObjects .

O exemplo a seguir oculta todos os objetos OLE na planilha um.

Worksheets(1).OLEObjects.Visible = False

Use o método Add para criar um novo objeto OLE e adicioná-lo à coleção OLEObjects. O exemplo a seguir cria um novo objeto OLE representando o arquivo de bitmap Arcade.bmp e o adiciona à planilha um.

Worksheets(1).OLEObjects.Add FileName:="arcade.gif"

O exemplo a seguir cria um novo controle ActiveX (uma caixa de listagem) e o adiciona à planilha um.

Worksheets(1).OLEObjects.Add ClassType:="Forms.ListBox.1"

Você pode usar o nome do código de um controle nos nomes de seus procedimentos de evento. No entanto, quando você retorna um controle da coleção Shapes ou OLEObjects para uma planilha, você deve usar o nome da forma, não o nome do código, para se referir ao controle pelo nome. Por exemplo, suponha que você adicione uma caixa de seleção a uma planilha e que o nome da forma padrão e o nome do código padrão sejam CaixadeSeleção1. Se você alterar o nome do código do controle digitando chkFinished ao lado de (Nome) na janela Propriedades, deverá usar chkFinished nos nomes de procedimentos de eventos, mas ainda aterá de usar CaixadeSeleção1 para retornar o controle da coleção Shapes ou OLEObject, como mostrado no exemplo a seguir.

Private Sub chkFinished_Click() 
 ActiveSheet.OLEObjects("CheckBox1").Object.Value = 1 
End Sub

Métodos

Propriedades

Confira também

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.