Funzione GetObject (JScript 8.0)
Aggiornamento: novembre 2007
Restituisce un riferimento a un oggetto di automazione da un file. Questa funzione può assumere due forme.
function GetObject(class : String)
function GetObject(pathname : String [, class : String])
Argomenti
class
Obbligatorio. Stringa nella forma "appName.objectType", dove appName è il nome dell'applicazione che fornisce l'oggetto e objectType è il tipo o la classe dell'oggetto da creare.pathname
Obbligatorio. Percorso completo e nome del file contenente l'oggetto da recuperare. Se pathname è omesso, l'argomento class diventa obbligatorio.
Note
Utilizzare la funzione GetObject per accedere a un oggetto di automazione da un file. Assegnare l'oggetto restituito da GetObject alla variabile oggetto. Di seguito è riportato un esempio:
var CADObject;
CADObject = GetObject("C:\\CAD\\SCHEMA.CAD");
Quando si esegue questo codice, viene avviata l'applicazione associata al percorso specificato in pathname e attivato l'oggetto incluso nel file specificato. Se pathname è una stringa di lunghezza zero (""), GetObject restituirà una nuova istanza dell'oggetto del tipo specificato. Se l'argomento pathname viene omesso, la funzione GetObject restituirà un oggetto correntemente attivo del tipo specificato. Se non esiste alcun oggetto del tipo specificato, verrà generato un errore.
In alcune applicazioni è possibile attivare parte di un file. Per eseguire questa operazione, è necessario aggiungere un punto esclamativo (!) alla fine del nome del file, seguito da una stringa che identifica la parte del file che si desidera attivare. Per ulteriori informazioni sulle modalità di creazione di tale stringa, consultare la documentazione dell'applicazione nella quale è stato creato l'oggetto.
In un'applicazione di disegno, ad esempio, è possibile memorizzare in un file un disegno a più livelli. Per attivare il livello layer3 del documento SCHEMA.CAD, è possibile utilizzare il codice seguente:
var LayerObject = GetObject("C:\\CAD\\SCHEMA.CAD!Layer3");
Se non si specifica la classe dell'oggetto, tramite l'automazione vengono identificati l'applicazione da avviare e l'oggetto da attivare in base al nome del file specificato. Con alcuni file, tuttavia, vengono supportate più classi di oggetti. Un disegno, ad esempio, può supportare tre diversi tipi di oggetti, ovvero un oggetto applicazione, un oggetto disegno e un oggetto barra degli strumenti, appartenenti tutti allo stesso file. Per specificare l'oggetto di un file da attivare, utilizzare l'argomento facoltativo class. Di seguito è riportato un esempio:
var MyObject;
MyObject = GetObject("C:\\DRAWINGS\\SAMPLE.DRW", "FIGMENT.DRAWING");
Nell'esempio, FIGMENT è il nome di un'applicazione di disegno e DRAWING è uno dei tipi di oggetto supportati. Una volta attivato un oggetto, è possibile farvi riferimento nel codice utilizzando la variabile oggetto definita. Nell'esempio precedente, per accedere alle proprietà e ai metodi del nuovo oggetto, viene utilizzata la variabile oggetto MyObject. Di seguito è riportato un esempio:
MyObject.Line(9, 90);
MyObject.InsertText(9, 100, "Hello, world.");
MyObject.SaveAs("C:\\DRAWINGS\\SAMPLE.DRW");
.gif "Nota") Nota: |
|---|
Utilizzare la funzione GetObject quando è disponibile un'istanza corrente dell'oggetto o se si desidera creare l'oggetto con un file già caricato. In caso contrario, utilizzare l'oggetto ActiveXObject. |
Se un oggetto viene registrato come oggetto a singola istanza, verrà creata una sola istanza dell'oggetto, indipendentemente dal numero di esecuzioni dell'oggetto ActiveXObject. Quando si chiama la funzione GetObject specificando una sintassi con stringa di lunghezza zero ("") con un oggetto a singola istanza, verrà sempre restituita la stessa istanza e se l'argomento pathname viene omesso, verrà generato un errore.