Função GetObject (JScript 8.0)
Retorna uma referência a um objeto Automation de um arquivo.Há duas formas da função.
function GetObject(class : String)
function GetObject(pathname : String [, class : String])
Argumentos
class
Obrigatório.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 o nome do arquivo que contém o objeto para recuperar.If nome do caminho for omitido, class é necessário.
Comentários
Use o GetObject função para acessar um objeto Automation a partir de um arquivo. Atribua o objeto retornado por GetObject a variável de objeto. Por exemplo:
var CADObject;
CADObject = GetObject("C:\\CAD\\SCHEMA.CAD");
Quando esse código é executado, o aplicativo associado com o especificado nome do caminho é iniciado e o objeto no arquivo especificado é ativado.If nome do caminho is a cadeia de comprimento zero (""), GetObject Retorna uma nova instância de objeto do tipo especificado. Se o nome do 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 participante do nome de arquivo e siga-lo com uma seqüência de caracteres que identifica a parte do arquivo que 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 arquivoVocê pode usar o código a seguir para ativar uma camada dentro de um desenho chamado SCHEMA.CAD:
var LayerObject = GetObject("C:\\CAD\\SCHEMA.CAD!Layer3");
Se don você não especificar a classe do objeto, automação determina qual aplicativo Iniciar e ativar, qual objeto com base no nome de arquivo que você fornecer.No entanto, alguns arquivos podem suporta mais de uma classe de objeto.Por exemplo, um desenho pode oferecer suporte a três tipos diferentes de objetos: um objeto aplicativo, um objeto de desenho e um objeto 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 função quando há uma instância corrente do objeto ou se você deseja criar o objeto com um arquivo já carregado. Se houver houver instância corrente e você não deseja que o objeto iniciado com um arquivo carregado, use o ActiveXObject objeto. |
Se um objeto tiver se auto-registrado sistema autônomo 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, GetObjectsempre retorna a mesma instância quando chamado com a seqüência de caracteres de comprimento zero ("") causa um erro sintaxe e se o nome do caminho argumento for omitido.