Compartilhar via


Objeto de ActiveXObject

Um objeto que fornece uma interface para um objeto de automação.

function ActiveXObject(ProgID : String [, location : String])

Argumentos

  • ProgID
    Obrigatório. Uma string no formato "serverName.typeName", onde serverName é o nome do aplicativo, fornecendo o objeto e typeName é o nome do tipo ou classe do objeto para criar.

  • location
    Opcional. O nome do servidor de rede onde o objeto está a ser criado.

Comentários

Geralmente, um servidor de automação fornece pelo menos um tipo de objeto. Por exemplo, um aplicativo de processamento de texto pode fornecer um objeto de aplicativo, um objeto de documento e um objeto da barra de ferramentas.

O código a seguir inicia um aplicativo (neste caso, uma planilha do Microsoft Excel), chamando o ActiveXObject construtor do objeto. O ActiveXObject permite que você consulte o aplicativo em seu código. Usando o exemplo a seguir, você pode acessar propriedades e métodos do novo objeto usando a variável de objeto ExcelSheet e outros objetos do Excel, incluindo o objeto Application e a coleção de ActiveSheet.Cells.

// Declare the variables
var Excel, Book;

// Create the Excel application object.
Excel = new ActiveXObject("Excel.Application");

// Make Excel visible.
Excel.Visible = true;

// Create a new work book.
Book = Excel.Workbooks.Add()

// Place some text in the first cell of the sheet.
Book.ActiveSheet.Cells(1,1).Value = "This is column A, row 1";

// Save the sheet.
Book.SaveAs("C:\\TEST.XLS");

// Close Excel with the Quit method on the Application object.
Excel.Application.Quit();

A criação de um objeto em um servidor remoto só pode ser realizada quando o Internet security está desativado. Você pode criar um objeto em um computador em rede remoto passando o nome do computador para o servername o argumento de ActiveXObject. Esse nome é o mesmo que a parte do nome de máquina de um nome de compartilhamento. Para um compartilhamento de rede chamado "\\MyServer\public", o servername é "myserver". Além disso, você pode especificar servername usando o formato DNS ou endereço IP.

O código a seguir retorna o número de versão de uma instância do Excel em execução em um computador de rede remoto denominado "myserver":

function GetAppVersion() {
   var Excel = new ActiveXObject("Excel.Application", "MyServer");
   return(Excel.Version);
}

Um erro ocorre se o servidor remoto especificado não existe ou não foi encontrado.

Propriedades e métodos

Um ActiveXObject objeto tem propriedades intrínsecas ou métodos; Ele permite que você acesse as propriedades e métodos do objeto de automação.

Requisitos

Versão 1

Consulte também

Referência

Operador New

Função de GetObject (JScript 10.0)