Contexto global.GetCOMObject

Contexto global

GetCOMObject

Disponible desde la versión 8.0.

Sintaxis:

GetCOMObject(<NombreArchivo>, <NombreDeClaseCOM>)

Parámetros:

<NombreArchivo> (opcional)

Tipo: Cadena.
Nombre del archivo, incluyendo la ruta completa.

<NombreDeClaseCOM> (opcional)

Tipo: Cadena.
Nombre de la clase COM, cuya copia necesita ser creada o recibida. Si la extensión del nombre de archivo indicada en el primer parámetro identifica completamente la clase del objeto, entonces el parámetro puede ser omitido.

Valor devuelto:

Tipo: COMObject.

Descripción:

La principal aplicación de la función GetCOMObject es recibir el COMObject correspondiente a un archivo. Debe proporcionar el nombre del archivo, que definirá el COMObject como el primer parámetro. Por ejemplo, el fragmento de código:
Tab = GetCOMObject(“C:\DATA\DATA.XLS”);
crea el objeto Excel.Application y lo utiliza para abrir el archivo del documento “C:\DATA\DATA.XLS”. Si el archivo indicado no se abre con MS Excel, entonces se pasa una referencia a un objeto existente.
Debe establecerse una asignación entre la clase COM y la extensión del nombre de archivo para los archivos pasados como parámetros a esta función.
Si se proporciona una cadena vacía como nombre de archivo, se creará una nueva copia del objeto. En este caso, debe proporcionar el nombre de la clase COM.
Por ejemplo, el fragmento de código:
Tab = GetCOMObject(“”, “Excel.Application”);
crea un nuevo documento de Excel. Más tarde, este documento se puede llenar y guardar en un archivo.
Si el primer parámetro está vacío, se intentará recibir un objeto activo del tipo indicado. Si no hay un objeto activo de este tipo en este momento, se producirá una excepción. Por ejemplo, como resultado del operador:
P = GetCOMObject( , “Excel.Application”);
La variable P recibe un valor de tipo COMObject, correspondiente a la aplicación MS Excel activa, si existe dicho valor, o de lo contrario se produce una excepción.

Disponibilidad:

Cliente ligero, cliente web, servidor, cliente grueso, conexión externa.

Ejemplo:

// Recibir objeto COM, correspondiente a un archivo

Tab = GetCOMObject(“C:\DATA\DATA.XLS”);

// Crear nueva copia del objeto

Tab = GetCOMObject(“”, “Excel.Application”);

// Recibir objeto activo

Tab = GetCOMObject( , “Excel.Application”);

Disponible desde:

Disponible desde la versión 8.0.