QuisontilsDll.dll

Ce fichier dll doit être placé dans le répertoire de Quisontils.
Il a pour but de permettre à un programme quelconque de connaître toutes les informations nécessaires pour appeler Quisontils.

• Informations à propos des albums (visibles) :
• function ListeDesAlbums(Buff : PChar ; const BuffMax : integer) : boolean; stdcall;
  // A l'appel Buff doit contenir le nom de l'album ou être vide pour tous
  // retourne la liste des albums référencés dans Buff séparés par Delimiteur
  // uniquement les albums visibles de l'extérieur, path complets
  // Si le buffer est de taille insuffisante, la fonction retourne false
• function TailleDeListeDesAlbums(Buff : PChar ; const BuffMax : integer) : integer; stdcall;
  // A l'appel Buff doit contenir le nom de l'album ou être vide pour tous
  // retourne la taille nécessaire pour exécuter sans problème ListeDesAlbums
• function NombreDesAlbums(Buff : PChar ; const BuffMax : integer) : integer; stdcall;
  // A l'appel Buff doit contenir le nom de l'album ou être vide pour tous
  // retourne le nombre d'albums référencés dans Quisontils
• Informations à propos des personnages (des albums visibles) :
• function ListeDesPersonnages(Buff : PChar ; const BuffMax : integer) : boolean; stdcall;
  // A l'appel Buff doit contenir le nom de l'album ou être vide pour tous
  // retourne dans Buff la liste des personnages connus séparés par Delimiteur
  // Si le buffer est de taille insuffisante, la fonction retourne false
• function TailleDeListeDesPersonnages(Buff : PChar ; const BuffMax : integer) : integer; stdcall;
  // A l'appel Buff doit contenir le nom de l'album ou être vide pour tous
  // retourne la taille du buffer nécessaire à la liste des personnages
• function NombreDesPersonnages(Buff : PChar ; const BuffMax : integer) : integer; stdcall;
  // A l'appel Buff doit contenir le nom de l'album ou être vide pour tous
  // retourne le nombre de personnages trouvés
• Informations à propos des clés liens externes (des albums visibles) :
• function ListeDesCles(Buff : PChar ; const BuffMax : integer) : integer; stdcall;
  // A l'appel Buff doit contenir le nom de l'album ou être vide pour tous
  // retourne dans Buff la liste des cles connues séparées par Delimiteur
  // Si le buffer est de taille insuffisante, la fonction retourne false
• function TailleDeListeDesCles(Buff : PChar ; const BuffMax : integer) : integer; stdcall;
  // A l'appel Buff doit contenir le nom de l'album ou être vide pour tous
  // retourne la taille du buffer nécessaire à la liste des clés
• function NombreDesCles(Buff : PChar ; const BuffMax : integer) : integer; stdcall;
  // A l'appel Buff doit contenir le nom de l'album ou être vide pour tous
  // retourne le nombre de personnages trouvés dans l'album Buff


• Informations utilitaires :
• function SignatureDll : ShortString; stdcall;
  // retourne la version (2.4)
• Procedure SetDelimiteur(sDelimiteur : shortstring); stdcall;
  // indique le ou la séquence de caractères servant de délimiteur
  // par défaut, c'est '||'
• Procedure SetTraces(logF : shortstring); stdcall;
  // si logF = '' ou pas d'appel : pas de traces sauf
  // si le fichier C:\QuisontilsDll.Log existe au chargement de la Dll
  // si logF <> '' enregistrement des traces dans logF
• function ModeActiviteQuisontils : integer; stdcall
  // retourne le mode d'activité de Quisontils
  // 0 si Quisontils est inactif
  // 1 si Quisontils fonctionne en mode autonome
  // 2 si Quisontils fonctionne en mode appel externe
• function GetPathQuisontils : shortstring; stdcall;
  // retourne le path d'installation de Quisontils

L'appel externe de Quisontils :

Lors de son appel depuis un programme externe, par exemple Ancestrologie, Quisontils se voit passer des paramètres qui sont :

• /CLE=clé_lien_externe, démarre Quisontils sur sa fenêtre Infos personnage correspondant à clé_lien_externe,
• /PERS=nom_personnage, démarre Quisontils sur sa fenêtre Infos personnage correspondant à nom_personnage,
• /ALBM=nom_album, recherche clé_lien_externe ou nom_personnage uniquement dans nom_album, sinon dans tous les albums sélectionnés pour les liens externes (voir préférences),
• /ONGL=n
     0 pour l'ouverture sur l'onglet identité,
     1 pour l'ouverture sur l'onglet photos,
     2 pour l'ouverture sur l'onglet portraits
• /SKIN=nom_skin, utilise nom_skin pour l'affichage.

Le mode appel externe ne s'active que si /CLE=clé_lien_externe OU /PERS=nom_personnage est présent, sinon Quisontils démarre en mode normal.

Exemple de ligne de commande d'appel : "Quisontils.exe /CLE=1234 /ONGL=1 /SKIN=corona.skn"