Compartilhar via


Função de GetObject (JScript 10.0)

Retorna uma referência a um objeto de automação de um arquivo. Há duas formas da função.

function GetObject(class : String)
function GetObject(pathname : String [, class : String])

Argumentos

  • class
    Obrigatório. Uma string no formato "appName.objectType", onde appName é o nome do aplicativo, fornecendo o objeto e objectType é o tipo ou classe de objeto para criar.

  • nome do caminho
    Obrigatório. Caminho completo e nome do arquivo que contém o objeto para recuperar. Se caminho for omitido, class é necessária.

Comentários

Use o GetObject a função para acessar um objeto de automação a partir de um arquivo. Atribua o objeto retornado por GetObject para a variável de objeto. Por exemplo:

var CADObject;
CADObject = GetObject("C:\\CAD\\SCHEMA.CAD");

Quando esse código é executado, o aplicativo associado ao caminho é iniciado, e o objeto no arquivo especificado é ativado. Se caminho é uma seqüência de comprimento zero (""), GetObject retorna uma nova instância de objeto do tipo especificado. Se o caminho argumento 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. Para fazer isso, adicione um ponto de exclamação (!) ao final do nome do arquivo e siga-o com uma seqüência de caracteres que identifica a parte do arquivo que você deseja ativar. Para obter informações sobre como criar essa sequência 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ê pode usar o código a seguir para ativar uma camada de um desenho chamado SCHEMA.CAD:

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

Se você não especificar a classe do objeto, automação determina qual aplicativo Iniciar e ativar, qual objeto com base no nome do arquivo que você fornecer. No entanto, alguns arquivos 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 da 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 class. Por exemplo:

var MyObject;
MyObject = GetObject("C:\\DRAWINGS\\SAMPLE.DRW", "FIGMENT.DRAWING");

No exemplo anterior, FIGMENT é o nome de um aplicativo de desenho e DRAWING é um dos tipos de objeto suportados. Depois que um objeto é ativado, faça referência a ele no código usando a variável de objeto definida. No exemplo anterior, você acessa propriedades e métodos do objeto novo 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çãoObservação

Use o GetObject funcionar quando há uma instância atual do objeto ou se você deseja criar o objeto com um arquivo já carregado. Se não houver nenhuma instância atual, e não desejar iniciar o objeto com um arquivo carregado, use o ActiveXObject objeto.

Se um objeto tiver se auto-registrado como um objeto de instância única, apenas uma instância do objeto é criada, não importa quantas vezes ActiveXObject é executado. Com um objeto de instância única, GetObject sempre retorna a mesma instância quando chamado com a seqüência de caracteres de comprimento zero ("") causa um erro de sintaxe e ele se a caminho argumento for omitido.

Requisitos

Versão 5

Consulte também

Referência

Objeto de ActiveXObject