Oggetto ActiveXObject
Aggiornamento: novembre 2007
Oggetto che fornisce un'interfaccia a un oggetto di automazione.
function ActiveXObject(ProgID : String [, location : String])
Argomenti
ProgID
Obbligatorio. Stringa in formato "NomeServer.NomeTipo", in cui NomeServer è il nome dell'applicazione che fornisce l'oggetto e NomeTipo è il nome del tipo o della classe dell'oggetto da creare.location
Facoltativo. Nome del server di rete in cui verrà creato l'oggetto.
Note
In genere, un server di automazione fornisce almeno un tipo di oggetto. Un programma di elaborazione di testi, ad esempio, può fornire un oggetto applicazione, un oggetto documento e un oggetto barra degli strumenti.
Nel codice riportato di seguito viene avviata un'applicazione, in questo caso un foglio di lavoro di Microsoft Excel, chiamando il costruttore dell'oggetto ActiveXObject. L'utilizzo di ActiveXObject consente di fare riferimento all'applicazione nel codice. Utilizzando l'esempio di codice seguente è possibile accedere alle proprietà e ai metodi del nuovo oggetto tramite la variabile oggetto ExcelSheet e altri oggetti Excel, tra cui l'oggetto Application e l'insieme 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();
La creazione di un oggetto in un server remoto può essere eseguita solo quando le funzioni di protezione in Internet sono disattivate. È possibile creare un oggetto in un computer remoto connesso in rete passando il nome del computer all'argomento servername di ActiveXObject. Tale nome corrisponde alla parte del nome del computer di un nome di condivisione. Per una condivisione di rete denominata "\\Server\pubblico", l'argomento servername è rappresentato da "Server". Inoltre, è possibile specificare servername utilizzando il formato DNS o un indirizzo IP.
Nel seguente codice viene restituito il numero di versione di un'istanza di Excel eseguita in un computer collegato in rete e denominato "MyServer":
function GetAppVersion() {
var Excel = new ActiveXObject("Excel.Application", "MyServer");
return(Excel.Version);
}
Se il server remoto specificato non esiste o non viene trovato, verrà generato un errore.
Proprietà e metodi
Un oggetto ActiveXObject non è dotato di proprietà o metodi intrinseci, ma consente di accedere alle proprietà e ai metodi dell'oggetto di automazione.