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");
.gif "Observação") Observaçã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.