Função GetObject

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Observação : A função, método, objeto ou propriedade descrito neste tópico será desabilitada se o Microsoft Jet Expression Service está em execução no modo de área restrita, o que impede a avaliação das expressões possivelmente não seguras. Para obter mais informações sobre o modo seguro, procure por "modo seguro" na Ajuda.

Retorna uma referência a um objeto fornecido por um componente ActiveX.

Sintaxe

GetObject ([nome do caminho ] [, classe ] )

A sintaxe da função GetObject possui os seguintes argumentos:

Argumento

Descrição

nome do caminho

Opcional. Variant (Cadeia). O caminho completo e o nome do arquivo que contém o objeto para recuperar. Se o caminho for omitido, classe é necessária.

classe

Opcional. Variant (Cadeia). Uma cadeia de caracteres que representa o classe do objeto.


A classeargumento usa a sintaxe appname.objecttype e tem estas partes:

Parte

Descrição

appname

Necessário. Variant (Cadeia). O nome do aplicativo fornecendo o objeto.

objecttype

Necessário. Variant (Cadeia). O tipo ou classe de objeto para criar.


Comentários

Observação : Exemplos a seguir demonstram o uso dessa função em um Visual Basic para módulo Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione a Referência do desenvolvedor na lista suspensa ao lado de pesquisa e insira um ou mais termos na caixa de pesquisa.

Use a função GetObject para acessar um objeto ActiveX a partir de um arquivo e atribuir o objeto a um variável de objeto. Use a instrução Set para atribuir o objeto retornado por GetObject à variável de objeto. Por exemplo:

Dim CADObject As Object
Set CADObject = GetObject("C:\CAD\SCHEMA.CAD")

Quando esse código é executado, o aplicativo associado com o caminho especificado é iniciado e o objeto no arquivo especificado é ativado.

Se o caminho é uma cadeia de caracteres de comprimento zero (""), GetObject retorna uma nova instância de objeto do tipo especificado. Se o argumento de caminho for omitido, GetObject retorna um objeto atualmente ativo do tipo especificado. Se nenhum objeto do tipo especificado existir, ocorrerá um erro.

Alguns aplicativos permitem que você ative a parte de um arquivo. Adicionar um ponto de exclamação (!) até o final do nome do arquivo e siga-la com uma cadeia de caracteres que identifique a parte do arquivo que você deseja ativar. Para obter informações sobre como criar essa cadeia de caracteres, consulte a documentação do aplicativo que criou o objeto.

Por exemplo, em um aplicativo de desenho, você pode ter várias camadas para um desenho armazenado em um arquivo. Você poderia usar o seguinte código para ativar uma camada em um desenho chamado SCHEMA.CAD:

Set LayerObject = GetObject("C:\CAD\SCHEMA.CAD!Layer3")

Se você não especificar do objeto classe, automação determina o aplicativo inicie e o objeto para ativar, com base no nome do arquivo que você fornecer. Alguns arquivos, no entanto, podem suportar mais de uma classe de objeto. Por exemplo, um desenho pode oferecer suporte a três tipos diferentes de objetos: um objeto de aplicativo , um objeto de desenho e um objeto de barra de ferramentas , todos os que fazem parte do mesmo arquivo. Para especificar qual objeto em um arquivo que você deseja ativar, use o argumento opcional classe . Por exemplo:

Dim MyObject As Object
Set MyObject = GetObject("C:\DRAWINGS\SAMPLE.DRW", _
"FIGMENT.DRAWING")

No exemplo, FIGMENT é que o nome de um aplicativo de desenho e DRAWING é um dos tipos de objeto que ele oferece suporte.

Quando um objeto é ativado, você se referir a ele no código usando a variável de objeto que você definiu. No exemplo anterior, você acessa propriedades e métodos do novo objeto usando a variável de objeto MyObject. Por exemplo:

MyObject.Line 9, 90
MyObject.InsertText 9, 100, "Hello, world."
MyObject.SaveAs "C:\DRAWINGS\SAMPLE.DRW"

Observação : Use a função GetObject quando há uma instância atual do objeto ou se você quiser criar o objeto com um arquivo já carregado. Se não houver nenhuma instância atual e você não deseja o objeto iniciado com um arquivo carregado, use a função CreateObject .

Se um objeto registrou ele mesmo como um objeto de instância única, apenas uma instância do objeto é criada, não importa quantas vezes CreateObject é executado. Com um objeto de instância única, GetObject sempre retorna a mesma instância quando chamado com a cadeia de caracteres de comprimento zero ("") sintaxe e ele causa um erro se o argumento de caminho é omitido. Você não pode usar o GetObject para obter uma referência a uma classe criada com o Visual Basic.

Exemplo

Este exemplo usa a função GetObject para obter uma referência a uma planilha específica Microsoft Office Excel 2007 (MyXL). Ele usa a propriedade Application da planilha para tornar o Excel visível, fechá-lo e assim por diante. Usando duas chamadas de API, o procedimento de sair Sub procura o Excel e se ele estiver executando, entra na tabela de objeto em execução. A primeira chamada de GetObject causa um erro se já não estiver executando o Microsoft Excel. No exemplo, o erro faz com que o sinalizador utilizada para ser definida como True. A segunda chamada de GetObject Especifica um arquivo para abrir. Se já não está executando o Excel, a segunda chamada inicia e retorna uma referência à planilha representada pelo arquivo especificado, meuteste. xls. O arquivo deve existir no local especificado; Caso contrário, o erro Erro de automação do Visual Basic é gerado. Em seguida, o código de exemplo torna o Excel e a janela que contém a planilha especificada visíveis. Por fim, caso não exista nenhuma versão anterior do Excel em execução, o código usa o aplicativo método do objeto t para fechar o Excel. Se o aplicativo já foi executado, nenhuma tentativa é feita para fechá-lo. A própria referência é lançada pela configurá-lo para nada.

' Declare necessary API routines:
Declare Function FindWindow Lib "user32" Alias _
"FindWindowA" (ByVal lpClassName as String, _
ByVal lpWindowName As Long) As Long
Declare Function SendMessage Lib "user32" Alias _
"SendMessageA" (ByVal hWnd as Long,ByVal wMsg as Long, _
ByVal wParam as Long, _
ByVal lParam As Long) As Long
Sub GetExcel()
Dim MyXL As Object ' Variable to hold reference
' to Microsoft Excel.
Dim ExcelWasNotRunning As Boolean ' Flag for final release.
' Test to see if there is a copy of Microsoft Excel already running.
On Error Resume Next ' Defer error trapping.
' GetObject function called without the first argument returns a
' reference to an instance of the application. If the application isn't
' running, an error occurs.
Set MyXL = GetObject(, "Excel.Application")
If Err.Number <> 0 Then ExcelWasNotRunning = True
Err.Clear ' Clear Err object in case error occurred.
' Check for Microsoft Excel. If Microsoft Excel is running,
' enter it into the Running Object table.
DetectExcel
' Set the object variable to reference the file you want to see.
Set MyXL = GetObject("c:\vb4\MYTEST.XLS")
' Show Microsoft Excel through its Application property. Then
' show the actual window containing the file using the Windows
' collection of the MyXL object reference.
MyXL.Application.Visible = True
MyXL.Parent.Windows(1).Visible = True
Do manipulations of your file here.
' ...
' If this copy of Microsoft Excel was not running when you
' started, close it using the Application property's Quit method.
' Note that when you try to quit Microsoft Excel, the
' title bar blinks and a message is displayed asking if you
' want to save any loaded files.
If ExcelWasNotRunning = True Then
MyXL.Application.Quit
End IF
Set MyXL = Nothing ' Release reference to the
' application and spreadsheet.
End Sub
Sub DetectExcel()
' Procedure dectects a running Excel and registers it.
Const WM_USER = 1024
Dim hWnd As Long
' If Excel is running this API call returns its handle.
hWnd = FindWindow("XLMAIN", 0)
If hWnd = 0 Then ' 0 means Excel not running.
Exit Sub
Else
' Excel is running so use the SendMessage API
' function to enter it in the Running Object Table.
SendMessage hWnd, WM_USER + 18, 0, 0
End If
End Sub

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×