UniqueInstance/fr

│ Deutsch (de) │ English (en) │ español (es) │ français (fr) │ polski (pl) │

À propos de

UniqueInstance fournit un moyen facile de forcer une seule instance par application fonctionnant en même temps.

Fonctions

• Facile d'utilisation: il suffit de glisser un composant dans le formulaire(form) principal.
• Fournit un mécanisme pour recevoir la ligne de commande des autres instances.

Comment utiliser(le composant)

Il suffit de le déposer dans le formulaire principal(il est sur l'onglet Système, recherchez un cercle rouge plein avec le chiffre "1" au milieu)

Propriétés:

• Enabled: Active / désactive le composant
• Identifier: utilisés pour fournir un moyen d'identifier l'application
• UpdateInterval: l'intervalle en millisecondes par lequel le composant surveillera des messages venant des nouvelles instances. N'a de sens que sous unix puisque, sous win32, le message est reçu à travers la boucle de message windows

événement

• OnOtherInstance: appelé si une autre instance est lancée. Reçoit les paramètres transmis à cette instance.

Comment utiliser (brut)

Ajouter l'unité uniqueinstanceraw à la section uses.

Appelez la fonction InstanceRunning : elle retourne vrai si il y a déjà une instance en cours d'exécution. Il existe deux variantes: une avec un argument d'identification (String) et une sans. La seconde utilise le nom de l'exécutable comme Identifiant.

Remarques

• Il a été développé et testé sous win32. Je n'ai pas une machine Linux à l'heure actuelle (Essais sous Ubuntu Linux et cela fonctionne bien. Par liyuangarcia en la date du 08/05/2007)
• Although it does not use platform dependent code, the callback mechanic used to pass the command line probably won't work in Linux. This occurs because TSimpleIPCServer under Linux does not call the OnMessage event (At least until some months ago when i tested it).
• If you put two TUniqueInstance components in the same application with the same identifier your application wont load.
• The Identifier is optional both to the function and the component. In the case it's not used, the executable name is used as a Identifier. The consequence is that if someone changes the exe name another instance will not be identified.
• To make sure a application will not avoid other launching you can use a GUID as the Identifier

Historique

• 02/10/07 - Version 0.2
  • Basé sur fpc 2.2.0
  • implémentation de la réception des paramètres sous unix
  • Optimisations générales et nettoyage du code
• 16/12/06 - réalisation initiale. Voir mon blog pour savoir comment cela à commencé.

Auteur

Luiz Américo Pereira Câmara

Licence

LGPL Modifié

Téléchargement

Lazarus CCR sourceforge.