Altova MapForce 2024 Professional Edition

La interfaz Application corresponde a un objeto de aplicación de MapForce. También es el principal punto de acceso para la aplicación MapForce. Esta interfaz es el punto de partida para realizar cualquier otra operación con MapForce o para obtener o crear otros objetos de automatización relacionados con MapForce. Para obtener información sobre cómo crear una instancia del objeto Application, consulte el apartado Accessing the API.

 

Propiedades para navegar en el modelo del objeto:

 

Application

Parent

Options

Project

Documents

 

Estado de la aplicación:

 

Visible

Name

Quit

Status

WindowHandle

 

Diseños de MapForce:

 

NewDocument

OpenDocument

OpenURL

ActiveDocument

 

Proyectos de MapForce:

 

NewProject

OpenProject

ActiveProject

 

Generación de código en MapForce:

 

HighlightSerializedMarker

 

Recursos globales:

 

GlobalResourceConfig

GlobalResourceFile

 

Información de la versión:

 

Edition

IsAPISupported

MajorVersion

MinorVersion

 

Propiedades

Nombre

Descripción

ActiveDocument

De solo lectura.

Devuelve el objeto de automatización del documento activo en ese momento. Esta propiedad devuelve lo mismo que Documents.ActiveDocument.

ActiveProject

De solo lectura.

Devuelve el objeto de automatización del proyecto activo en ese momento.

Application

De solo lectura.

Obtiene el objeto de nivel superior de la aplicación.

Documents

De solo lectura.

Devuelve una colección de todos los documentos abiertos en ese momento.

Edition

De solo lectura.

Devuelve la edición de la aplicación, por ejemplo "Altova MapForce Enterprise Edition" para esa edición.

GlobalResourceConfig

Obtiene o indica el nombre del archivo de configuración activo para los recursos globales. Por defecto, este archivo se llama GlobalResources.xml.

 

El archivo de configuración se puede renombrar y guardar en cualquier ubicación. Eso significa que puede tener varios archivos XML para los recursos globales. Sin embargo, solo uno de esos archivos XML para los recursos globales puede estar activo en cada sesión y por cada aplicación, que solo podrá usar las definiciones que contenga el archivo activo.

GlobalResourceFile

Obtiene o indica el archivo de definición de los recursos globales. Por defecto, este archivo se llama GlobalResources.xml.

IsAPISupported

De solo lectura.

Devuelve true si la API es compatible con esta versión de MapForce.

LibraryImports

De solo lectura.

Obtiene las bibliotecas importadas. En la interfaz gráfica del usuario de MapForce estas se corresponden con entradas de la ventana Gestionar bibliotecas añadidas a nivel de la aplicación.

MajorVersion

De solo lectura.

Obtiene el número principal de la versión de MapForce. La versión se empieza a calcular en 1998 y aumenta con cada año. Por ejemplo, la versión principal para el release 2016 es "18".

MinorVersion

De solo lectura.

El número complementario del número principal de la versión del producto, por ejemplo 2 para 2006 R2 SP1.

Name

De solo lectura.

El nombre de la aplicación.

Options

De solo lectura.

Esta propiedad da acceso a las opciones que configuran la generación de código.

Parent

De solo lectura.

El objeto de nivel superior según el modelo del objeto.

ServicePackVersion

De solo lectura.

El service pack de la versión del producto, por ejemplo 1 para 2016 R2 SP1.

Status

De solo lectura.

El estado de la aplicación. Es uno de los valores de la enumeración ENUMApplicationStatus.

Visible

True si MapForce se muestra en pantalla (aunque puede que esté oculto por otras aplicaciones o minimizado).

 

False si MapForce está oculto. El valor predeterminado para MapForce es false cuando este se inicia de forma automática debido a una solicitud del servidor de automatización Application. En todos los demás casos la propiedad se inicia como true.

 

Se entiende que una instancia visible de la aplicación la controla el usuario (y puede que clientes conectados mediante la interfaz de automatización). La aplicación solo se detendrá por solicitud explícita de un usuario. Para cerrar una instancia de la aplicación, cambie su visibilidad a false y elimine todas las referencias a esta instancia dentro de su programa. La instancia de la aplicación se cerrará automáticamente cuando ningún cliente COM haga referencia a ella.

WindowHandle

De solo lectura.

Obtiene la aplicación Windows Handle.

 

Métodos

Nombre

Descripción

HighlightSerializedMarker

Use este método para resaltar la ubicación en un archivo de asignación previamente seriado. Primero se cargará el documento correspondiente si no lo ha hecho ya. En Document.GenerateCodeEx se explica el método para obtener un indicador seriado.

NewDocument

Crea un documento nuevo vacío. El documento recién abierto se convierte en el ActiveDocument. Este método es una forma abreviada de Documents.NewDocument.

NewProject

Crea un proyecto nuevo vacío. El proyecto actual está cerrado. El proyecto nuevo es accesible desde ActiveProject.

NewWebServiceProject

Crea un servicio web nuevo vacío. El proyecto nuevo es accesible desde ActiveProject. Este método solo está disponible en MapForce Enterprise Edition.

OpenDocument

Carga un documento previamente guardado y continúa trabajando en él. El documento que acaba de abrir se convierte en el ActiveDocument. Este método es una forma abreviada de Documents.OpenDocument.

OpenProject

Abre un proyecto de MapForce ya existente (*.mfp). El proyecto actual está cerrado. El proyecto que acaba de crear es accesible desde ActiveProject.

OpenURL

Carga un archivo previamente guardado desde una ubicación URL. Permite indicar nombre de usuario y contraseña.

Quit

Se desconecta de MapForce para permitir que la aplicación se cierre. El uso de este método es opcional, ya que MapForce controla todas las conexiones COM externas y reconoce de forma automática cuando alguna se desconecta. Para obtener más información sobre el cierre automático, consulte la propiedad Visible.

 

Eventos

Nombre

Descripción

OnDocumentOpened

Este evento se desencadena cuando se abre un documento, sea nuevo o ya existente. El evento de cierre correspondiente es Document.OnDocumentClosed.

OnProjectOpened

Este evento se desencadena cuando se carga un proyecto en la aplicación. El evento de cierre correspondiente es Project.OnProjectClosed.

OnShutdown

Este evento se desencadena cuando se cierra la aplicación.

© 2017-2023 Altova GmbH