Partager via


ActiveXObject, objet

Objet qui fournit une interface à un objet Automation.

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

Arguments

  • ProgID
    Obligatoire. Chaîne présentée sous la forme de « NomServeur.NomType », NomServeur représentant l'application qui fournit l'objet et NomType le nom du type ou de la classe de l'objet à créer.

  • location
    Facultatif. Nom du serveur réseau au niveau duquel l'objet doit être créé.

Notes

En général, un serveur Automation fournit au moins un type d'objet. Par exemple, une application de traitement de texte peut fournir un objet application, un objet document et un objet barre d'outils.

Le code suivant démarre une application (dans ce cas, une feuille de calcul Microsoft Excel) en appelant le constructeur d'objet ActiveXObject. L'objet ActiveXObject vous permet de faire référence à l'application dans votre code. Dans l'exemple suivant, vous pouvez accéder aux propriétés et aux méthodes du nouvel objet à l'aide de la variable objet ExcelSheet et d'autres objets Excel, notamment l'objet Application et la collection 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 création d'un objet sur un serveur distant est possible uniquement lorsque la sécurité Internet est désactivée. Vous pouvez créer un objet sur un ordinateur distant du réseau en passant le nom de l'ordinateur à l'argument servername d'ActiveXObject. Dans un nom de partage, ce nom correspond à la partie réservée au nom de l'ordinateur. Par exemple, dans le nom de partage réseau « \\myserver\public », servername correspond à « myserver ». En outre, vous pouvez spécifier l'argument servername au format DNS ou sous la forme d'une adresse IP.

Le code suivant retourne le numéro de version d'une instance d'Excel qui s'exécute sur un ordinateur réseau distant appelé « MyServer » :

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

Une erreur se produit si le serveur distant spécifié est inexistant ou introuvable.

Propriétés et méthodes

Un objet ActiveXObject ne possède pas de propriétés ni de méthodes intrinsèques ; il vous permet d'accéder aux propriétés et méthodes de l'objet Automation.

Configuration requise

Version 1

Voir aussi

Référence

new, opérateur

GetObject, fonction (JScript 10.0)