(Français) Collections de procédures

Sorry, this entry is only available in French. For the sake of viewer convenience, the content is shown below in the alternative language. You may click the link to switch the active language.

Le framework vient avec 10 collections de procédures qui sont autant de “boites à outils”.

Certaines de ces fonctions ont été décrites par d’autres développeurs sur leur site personnel ou sur un forum. Merci à eux pour leur contribution ! La référence de la page sur internet est systématiquement mise au début des procédures concernées. Ce framework les a rassemblé et uniformisées pour être dans l’esprit du WLangage.

La collection de procédure COL_PCS

Il faut tout d’abord parler d’une classe bien spéciale COL_PCS.

Il suffit de regarder la documentation officielle de PCSOFT pour voir que certaines fonctions sont limitées et/ou inexistantes sur certaines plateformes et/ou leurs constantes indisponibles sur l’une ou l’autre plateforme. Ce framework a l’ambition d’être utile pour tout projet, sur toute plateforme. Voila pourquoi une 20aine fonctions ont été “refaite” pour atteindre ce but.

La collection de procédures COL_Conversion

La majorité des fonctions portent sur la conversion d’unités : accélération, angle, durée, force, fréquence, longueur, masse, pression, puissance, surface, température, travail, vitesse et volume et même informatique (avec les multiplicateurs par 1024).  Ceci implique une longue liste de multiplicateurs (de 10-24 à 1024) et d’unités disponibles sous forme d’énumération avec leur valeur de conversion (par rapport au Système International).  S’ajoutent des conversions sous format “texte” comme PiedPouceVersMètre (et son inverse), permettant de convertir 10’5 en 3,175 mètres.

Viennent ensuite les conversions de formats et leur inverses : AnsiVersBase64 (utile pour les échanges avec des services réseau), AnsiVersUnicodeAnsi (pour transformer les accents et caractères spéciaux en \uXXXX), BinaireVersEntier (chaine de 1 et de 0 vers un entier), ChaineVersHexa (“aB$” donne “614224” tel que sur cette page) et UTF16VersAnsi.

La fonction PhonétiqueFrançais permet aussi d’utiliser un algorithme différent de la fonction Phonétique de PCSOFT mais surtout de pouvoir l’utiliser en Java, Android et iOS.

La tendance étant aux échanges au format JSON (adieu XML on t’aimait bien). Un effort à été fait sur une conversion qui est notamment utilisé dans cTrace : VariableVersJSON. Elle permet de transformer n’importe quelle variable ou objet en JSON, contrairement à la fonction Sérialise du WLangage qui est limité quand il s’agit d’objets trop complexes.

Viennent ensuite quelques conversions de dates (différences en minutes ou en seconde entre 2 date/heure et transformation des dates PHP dans les 2 sens) et l’extrapolation de la fonction DateDuJour/DateSys() à d’autres jours tels que : AvantHier, Hier, Demain et AprèsDemain.

Enfin il est possible de vérifier un chemin de fichier pour éviter les caractères interdits avec ChaineVersNomDeFichier et de transformer une URL en une structure plus facile à manipuler.

La collection de procédures COL_GUI

GUI pour “Graphic User Interface” évidemment. Tout ce qui concerne donc l’interface homme/machine et donc des champs et des fenêtres :

  • des toast avec une couleur de fond définis (pour les erreurs, les avertissements et les infos),
  • du traitement sur les colonnes de table (hauteur de titre, réglage automatique des largeurs de colonnes, position du curseur horizontal pour voir une colonne particulière)
  • le remplissage de combos pour les unités ou leurs multiplicateurs (voir COL_Conversion ci-dessus)
  • l’énumération des champs pour pouvoir intervenir sur des applications tierces (EnumèreElementExt équivalent à EnumèreElement) : pousser sur un bouton, mettre une valeur dans un champ de saisie, …
  • d’autres fonctions utiles au quotidien : déplacement d’un groupe de champ, ouverture de Google Map en passant une adresse, limitation du contenu d’une liste (une ligne insérée en haut efface la dernière), …

La collection de procédure COL_Impression

Fini de faire toutes une série d’états dans votre logiciel, la fonction ImprimeTable imprime n’importe quelle table à l’écran telle quelle.

Une 50aine d’options sont disponibles : marges, nbr d’exemplaires, couleur des lignes et de fond de titre, filtres, couleur/tons de gris, coche graphique ou numérique, mémo image, orientation, nombre/totaux/moyenne, titres du document et des colonnes, … tous les détails sur cette page.  Cette fonction est liée avec la fenêtre interne FI_Page permettant à l’utilisateur de personnaliser visuellement toutes ces options.

L’autre fonction intéressante permet d’imprimer directement une image. La dernière fonction permet d’imposer ou de récupérer les marges de l’imprimante.

La collection de procédures COL_Log

Cette collection sert à surcharger l’appel aux boites de dialogue et aux impressions pour pouvoir les écrire dans le fichier Log.

La collection de procédures COL_Matériel

(Presque) tout savoir sur le matériel se trouve ici : 5 fonctions pour les imprimantes (ajout dans Windows, valeurs du DPI, …), 2 fonctions pour la souris (boutons et roulette), 3 fonctions pour les composants de l’ordinateur (processeur, mémoire et port COM), 3 fonctions pour le clavier (verrou, vitesse de répétition et délai avant répétition). La gestion des cartes réseau est faite dans une collection de procédures spécifique (voir ci-dessous).

La collection de procédure COL_ODBCSource

Sert à gérer les sources ODBC. Ces procédures sont notamment appelées dans les classes cBaseDeDonnéesXXXX pour paramétrer automatiquement la connexion ODBC.

La collection de procédures COL_Réseau

Cette collection permet d’en savoir (beaucoup) plus sur les cartes réseau installées sur l’ordinateur et leurs adresses IP reliées grâce aux fonctions AdapteurNombre et AdapteurInfo.

Elle contient également d’autres méthodes pour connaître le contexte réseau dans lequel se trouve l’ordinateur suite au login de l’utilisateur : liste de ses groupes sur le domaine, savoir si il a des droits administrateurs, le nom de la connexion internet et le nom du domaine courant.

La collection de procédures COL_Vérification

Contient une série de fonctions pour vérifier la validité de certaines données (EstChiffre, EstAnnéeBisextile, EstImageReconnue, EstNuméroTéléphone, …) ou de numéro utilisé dans l’administration (ex : RIB en France, NAS au Québec).

La collection de procédures COL_WIN

Sont rassemblées ici toutes les procédures qui sont spécifiques à l’environnement Windows (toutes appelles les API Windows).

Ce sont donc 5 fonctions qui pilotent la barre de tâches, une fonction pour récupérer l’icône associé à un fichier, la gestion des fichiers récents, 2 fonctions pour l’UAC, l’activation de l’écran de veille, l’ouverture de la fenêtre standard pour arrêter Windows, … Une partie de ces fonctions a été glanée sur internet (référence en haut des procédures concernées).

Ce site n'a aucun lien avec la société PC SOFT®. Les marques "WinDev" et "WebDev" sont des marques déposées de la société PC SOFT.