Altova MapForce 2025 Enterprise Edition

L’interface de l’application est l’interface d’un objet d’application de MapForce. Elle représente le point d’accès principal pour l’application MapForce elle-même. Cette interface est le point de départ pour toute opération supplémentaire avec MapForce ou pour extraire ou créer d'autres objets d’automatisation liés à MapForce. Pour toute information concernant la création d’une instance de l'objet d’application, voir Accéder à l’API.

 

Propriétés pour parcourir le modèle d’objet :

 

Application

Parent

Options

Projet

Documents

 

Statut de l’application :

 

visible

Nom

Quitter

Statut

WindowHandle

 

Designs de MapForce :

 

NewDocument

OpenDocument

OpenURL

ActiveDocument

 

Projets de MapForce :

 

NewProject

OpenProject

ProjetActif

 

Génération de code de MapForce :

 

HighlightSerializedMarker

 

Ressources globales :

 

GlobalResourceConfig

GlobalResourceFile

 

Information de version :

 

Édition

IsAPISupported

MajorVersion

MinorVersion

 

Propriétés

Nom

Description

ActiveDocument

Lecture seule.

Retourne l’objet d’automatisation du document actif actuel. Cette propriété retourne de la même manière que Documents.ActiveDocument.

ProjetActif

Lecture seule.

Retourne l’objet d’automatisation du projet actif actuel.

Application

Lecture seule.

Extrait l’objet de l’application de premier niveau.

Documents

Lecture seule.

Retourne une collection de tous les documents actuellement ouverts.

Édition

Lecture seule.

Renvoie l’édition de l’application, par ex., « Altova MapForce Enterprise Edition » pour l’édition d’enterprise.

GlobalResourceConfig

Obtient ou définit le nom du fichier de configuration de la ressource globale active. Par défaut, le fichier est appelé GlobalResources.xml.

 

Le fichier de configuration peut être renommé et enregistré sous tout emplacement. Vous pouvez donc avoir de multiples fichiers XML de ressources globales. Toutefois, seulement un de ces fichiers XML de ressources globales peut être actif par application, à usage unique, et uniquement les définitions contenues dans ce fichier seront disponibles pour l’application.

GlobalResourceFile

Obtient ou définit le fichier de définition de la ressource globale. Par défaut, le fichier est appelé GlobalResources.xml.

IsAPISupported

Lecture seule.

Renvoie true si l’API est prises en charge dans cette version de MapForce.

LibraryImports

Lecture seule.

Obtient une collection de bibliothèques importées. Dans l’interface utilisateur graphique de MapForce, celles-ci correspondent aux entrées de la fenêtre Gérer les bibliothèques, ajoutées au niveau de l’application.

MajorVersion

Lecture seule.

Obtient le numéro de version majeur de MapForce. La version est calculée commençant en 1998 et incrémentée de un chaque année. Par exemple, la version majeure est « 18 » pour la release 2016.

MinorVersion

Lecture seule.

Le numéro de version mineur du produit, par exemple 2 pour 2006 R2 SP1.

Nom

Lecture seule.

Le nom de l’application.

Options

Lecture seule.

Cette propriété donne accès aux options qui configurent le code de génération.

Parent

Lecture seule.

L’objet parent selon le modèle d’objet.

ServicePackVersion

Lecture seule.

Le numéro de version du Service Pack, par exemple 1 pour 2016 R2 SP1.

Statut

Lecture seule.

Le statut de l’application. Il s’agit d’une des valeurs de l’énumération ENUMApplicationStatus.

Visible

True si MapForce est affiché à l’écran (cependant, cela pourrait être couvert par d’autres applications ou être iconisé).

 

False si MapForce est masqué. La valeur par défaut pour MapForce lorsqu’il est automatiquement démarré suite à une requête depuis le serveur Automation Application est false. Dans tous les autres cas, la propriété est initialisée par true.

 

On peut dire qu’une instance d’application qui est visible est contrôlée par l’utilisateur (et éventuellement par des clients connectés par le biais de l’interface automation). Elle ne s’arrêtera que si elle reçoit une requête explicite de l’utilisateur. Pour arrêter une instance d’application, définissez sa visibilité à false et effacez toutes les références de cette instance à l’intérieur de votre programme. L’instance d’application s’arrêtera automatiquement quand aucun autre client COM n’a de références y afférentes.

WindowHandle

Lecture seule.

Extrait Window Handle de l’application.

 

Méthodes

Nom

Description

HighlightSerializedMarker

Utilisez cette méthode pour marquer un emplacement dans un fichier de mappage qui a été précédemment sérialisé. Si le document correspondant n’a pas encore été chargé, il sera chargé en premier. Voir Document.GenerateCodeEx pour une méthode d’extraction d’un marqueur sérialisé.

NewDocument

Crée un nouveau document vide. Le nouveau document ouvert devient le ActiveDocument. Cette méthode est une forme raccourcie de Documents.NewDocument.

NewProject

Crée un nouveau document vide. Le projet actuel est fermé. Le nouveau projet est accessible sous ActiveProject.

NewWebServiceProject

Crée un nouveau projet Web Service vide. Le nouveau projet est accessible sous ActiveProject. Cette méthode est uniquement disponible dans MapForce Enterprise Edition.

OpenDocument

Charge un fichier de document précédemment enregistré et poursuit le travail dans le fichier. Le nouveau document ouvert devient le ActiveDocument. Cette méthode est une forme raccourcie de Documents.OpenDocument.

OpenProject

Ouvre un projet existant de Mapforce (*.mfp). Le projet actuel est fermé. Le projet récemment ouvert est accessible sous ActiveProject.

OpenURL

Charge un fichier de document précédemment enregistré depuis un emplacement URL. Permet la fourniture du nom d’utilisateur et du mot de passe.

Quitter

Se déconnecte de MapForce pour permettre à l’application de se fermer. Appeler cette méthode est optionnel puisque MapForce assure le suivi de connexions COM externes et reconnaît automatiquement une déconnexion. Pour plus d’information sur un arrêt automatique, voir la propriété Visible.

 

Événements

Nom

Description

OnDocumentOpened

Cet événement est déclenché quand un document existant ou un nouveau document est ouvert. L’événement de fermeture correspondant est Document.OnDocumentClosed.

OnProjectOpened

Cet événement est déclenché quand un document existant ou un nouveau document est chargé dans l’application. L’événement de fermeture correspondant est Document.OnDocumentClosed.

OnShutdown

Cet événement est déclenché quand l’application est en cours d’arrêt.

© 2018-2024 Altova GmbH