Bibliothèque de classes Host Access C++

Cette bibliothèque de classes C++ présente une abstraction complète orientée objet d'une connexion hôte qui comprend : la lecture et l'écriture de l'espace de présentation hôte (écran), l'énumération des champs à l'écran, la lecture de la zone d'indicateur de l'opérateur (OIA) pour les informations de statut, l'accès et la mise à jour des informations sur la fenêtre de l'émulateur visuel, le transfert de fichiers et l'exécution de notification asynchrone des événements importants. Les bibliothèques de classes prennent en charge les compilateurs Microsoft® Visual C++®.

La couche de la bibliothèque de classes Host Access C++ se compose d'un certain nombre de classes C++ disposées dans une hiérarchie de classes. Objets de classes Host Access illustre la hiérarchie d’héritage C++ de la couche de la bibliothèque de classes Host Access C++. Chaque objet hérite de la classe immédiatement au-dessus dans le diagramme.

Figure 1. Objets de classes Host Access

Affiche la structure des objets de la bibliothèque de classes Host Access.

Objets de classes Host Access montre également toutes les fonctions membres de chaque classe. Notez qu'en plus des fonctions affichées pour chaque classe, les classes héritent de toutes les fonctions de la classe parent. Par exemple, la fonction IsReady() est disponible sur les classes ECLSession, ECLPS, ECLOIA, ECLWinMetrics et ECLXfer.

Chaque classe est décrite brièvement dans les sections suivantes. Reportez-vous aux descriptions de classes individuelles dans ce chapitre pour plus de détails.

Tous les exemples présentés dans ce chapitre sont fournis dans le fichier ECLSAMPS.CPP. Ce fichier peut être utilisé pour compiler et exécuter n'importe lequel des exemples à l'aide de n'importe quel compilateur pris en charge.

Ci-dessous vous trouverez un bref aperçu des classes de la bibliothèque de classes Host Access C++. Chaque nom de classe commence par ECL, qui est le préfixe commun de la bibliothèque de classes Host Access.

  • ECLBase, sur la page Classe ECLBase, est la classe de base pour tous les objets ECL. Elle fournit quelques méthodes utilitaires de base telles que la conversion des noms et des descripteurs de connexion. Etant donné que tous les objets ECL héritent de cette classe, ces méthodes peuvent être utilisées sur n'importe quel objet ECL.
  • ECLConnection, sur la page Classe ECLConnection, représente une connexion Z and I Emulator for Windows unique et contient des informations de connexion telles que le statut de la connexion, le type de connexion (par exemple, 3270 ou 5250), ainsi que le nom et le descripteur de la connexion. Cette classe est également la classe de base pour tous les objets ECL spécifiques à la connexion tels que ECLPS et ECLOIA.
  • ECLConnList, sur la page Classe ECLConnList, contient une liste de toutes les connexions Z and I Emulator for Windows qui existaient au moment de la création de l'objet ou du dernier appel de la méthode Refresh. Chaque connexion est représentée par un objet ECLConnection.
  • ECLConnMgr, sur la page Classe ECLConnMgr, énumère toutes les connexions Z and I Emulator for Windows en cours d'exécution (windows) à l’aide de l’objet ECLConnList. Elle fournit également des méthodes pour démarrer de nouvelles connexions et arrêter les connexions.
  • ECLCommNotify, sur la page Classe ECLCommNotify, est une classe de notification qu'une application peut utiliser pour être avertie chaque fois qu'une connexion est déconnectée ou connectée à un hôte. Elle peut être utilisée pour surveiller le statut d'une connexion et prendre des mesures lorsqu'une connexion est déconnectée de manière inattendue.
  • ECLErr, sur la page Classe ECLErr, fournit une méthode permettant de renvoyer des informations sur les erreurs d'exécution à partir des classes de la bibliothèque de classes Host Access.
  • ECLField, sur la page Classe ECLField, contient des informations sur un seul champ à l'écran, telles que les attributs du champ, la couleur du champ, la position sur l'écran ou la longueur. Une méthode est également fournie pour mettre à jour les champs de saisie.
  • ECLFieldList, sur la page Classe ECLFieldList, contient une collection d'objets ECLField. Lorsque la méthode Refresh est appelée, l'écran hôte actuel est examiné et la liste des champs est extraite et utilisée pour créer la liste des objets ECLField. Une application peut utiliser cette collection pour gérer les champs sans avoir à créer elle-même la liste.
  • ECLKeyNotify, sur la page Classe ECLKeyNotify, est une classe de notification qu'une application peut utiliser pour être avertie des événements de frappe. L'application peut filtrer (supprimer) les frappes, les remplacer par d'autres frappes ou les supprimer.
  • ECLListener, sur la page Classe ECLListener, est la classe de base pour tous les nouveaux objets d'écoute d'événements HACL. Elle fournit des fonctions communes à tous les objets d'écoute.
  • ECLOIA, sur la page Classe ECLOIA, donne accès aux informations sur le statut de l'opérateur telles que les indicateurs de changement de vitesse, les conditions d'entrée interdites et les erreurs de communication.
  • ECLOIANotify, sur la page Classe ECLOIANotify, est une classe de base abstraite. Les applications créent des objets dérivés de cette classe pour recevoir une notification des modifications OIA.
  • ECLPS, sur la page Classe ECLPS, représente l'espace de présentation (écran) d'une seule connexion. Elle contient des méthodes permettant d'obtenir une copie du contenu de l'écran sous forme de plans de données. Chaque plan représente un aspect spécifique de l'espace de présentation, tel que le texte, les attributs de champ et les attributs de couleur. Des méthodes sont fournies pour rechercher des chaînes dans l'espace de présentation, envoyer des frappes au clavier à l'hôte, obtenir et définir la position du curseur de l'hôte et bien d'autres fonctions. Un objet ECLFieldList est également fourni et peut être utilisé pour énumérer la liste des champs à l'écran.
  • ECLPSEvent, sur la page Classe ECLPSEvent, est un objet événement qui est transmis aux écouteurs d'événements PS lorsque l'espace de présentation a été mis à jour. Il contient des informations sur l'événement, notamment la cause de la mise à jour et la partie de l'écran qui a été mise à jour.
  • ECLPSListener, sur la page Classe ECLPSListener, est une classe de base abstraite. Les applications créent des objets dérivés de cette classe pour recevoir les événements de mise à jour de l'espace de présentation avec toutes les informations fournies par l'objet ECLPSEvent.
  • ECLPSNotify, sur la page Classe ECLPSNotify, est une classe de base abstraite. Les applications créent des objets dérivés de cette classe pour recevoir une notification des mises à jour de l'espace de présentation avec un minimum d'informations.
  • ECLRecoNotify, sur la page Classe ECLRecoNotify, est une classe de base abstraite. Les applications créent des objets dérivés de cette classe pour recevoir des notifications de reconnaissances d'écran.
  • ECLScreenDesc, sur la page Classe ECLScreenDesc, est une classe utilisée pour décrire un seul écran hôte. Les objets de classe de description d'écran sont ensuite utilisés pour déclencher des événements lorsque l'écran hôte décrit apparaît ou pour attendre de manière synchrone un écran hôte particulier.
  • ECLScreenReco, sur la page Classe ECLScreenReco, est une classe utilisée pour collecter un ensemble d'objets de description d'écran et générer des événements asynchrones lorsque l'un des écrans de la collection apparaît dans l'espace de présentation.
  • ECLSession, sur la page Classe ECLSession, contient une collection de tous les objets spécifiques à la connexion. ECLSession peut être utilisé pour créer facilement un ensemble complet d'objets pour une connexion particulière.
  • ECLStartNotify, sur la page Classe ECLStartNotify, est une classe de notification qu'une application peut utiliser pour être avertie chaque fois qu'une connexion est démarrée ou arrêtée. Elle peut être utilisée pour surveiller le statut du système et prendre des mesures lorsqu'une connexion est fermée de manière inattendue.
  • ECLUpdateNotify, sur la page Classe ECLUpdateNotify, est une classe de notification qu'une application peut utiliser pour être avertie chaque fois que l'écran hôte ou l'OIA est mis à jour.
  • ECLWinMetrics, sur la page Classe ECLWinMetrics, représente la fenêtre physique dans laquelle l'émulation est exécutée. Des méthodes sont fournies pour obtenir et définir l'état de la fenêtre (min, max, restauré), la taille et la visibilité de la fenêtre.
  • ECLXfer, sur la page Classe ECLXfer, lance les transferts de fichiers vers ou depuis l'hôte via la connexion.
  • ECLPageSettings, sur la page Classe ECLPageSettings, contrôle et récupère les paramètres de la boîte de dialogue File > Page Setup de la session d'émulateur.
  • ECLPrinterSettings, sur la page Classe ECLPrinterSettings, contrôle et récupére les paramètres des boîtes de dialogue File > Printer Setup de la session d'émulateur.