Difference between revisions of "UniqueInstance/de"
From Free Pascal wiki
Jump to navigationJump to search| Line 21: | Line 21: | ||
* OnOtherInstance: wird aufgerufen, falls eine neue Instanz gestartet werden soll und empfängt die ggf. an diese übergebenen Parameter | * OnOtherInstance: wird aufgerufen, falls eine neue Instanz gestartet werden soll und empfängt die ggf. an diese übergebenen Parameter | ||
| − | === | + | === Anwendung (Raw) === |
| − | + | Hinzufügen von <b>uniqueinstanceraw</b> zur Uses-Klausel. | |
| − | + | Aufruf der <i>InstanceRunning</i>-Funktion: True wird zurückgegeben, falls bereits eine Instanz läuft. | |
| − | + | Es gibt zwei Varianten: | |
| − | + | ||
| − | * | + | 1. Ohne Argumente: |
| − | + | * UniqueInstance nutzt den Namen des Executables um dieses zu identifizieren. Parameter werden nicht übergeben. | |
| − | + | 2. Mit zwei Argumenten: | |
| + | * Identifier: Identifizierung der Anwendung | ||
| + | * SendParameters(default = false): Sendet vor dem beenden die ggf. übergebenen Parameter an die bereits laufende Instanz. | ||
=== Remarks === | === Remarks === | ||
Revision as of 20:03, 10 July 2008
│
Deutsch (de) │
English (en) │
español (es) │
français (fr) │
polski (pl) │
Über
UniqueInstance stellt einen einfachen Weg zur Verfügung, ein mehrfaches Starten der Anwendung zu verhindern.
Funktionen
- Einfach zu nutzen, es muss lediglich die Komponente auf das Hauptformular gesetzt werden.
- Stellt einen Mechanismus zur Verfügung, Parameter der anderen Instanzen zu empfangen.
Anwendung (Komponente)
Einfach die Komponente auf das Hauptformular platzieren.
Eigenschaften:
- Enabled: aktiviert/deaktiviert die Komponente
- Identifier: wird genutzt um die Anwendung zu identifizieren
- UpdateInterval: der Intervall (ms) in welchem die Komponente Nachrichten von neuen Instanzen empfängt. (Nur unter Linux relevant, da unter Windows die Systemeigene Nachrichtenschleife genutzt wird.
Event
- OnOtherInstance: wird aufgerufen, falls eine neue Instanz gestartet werden soll und empfängt die ggf. an diese übergebenen Parameter
Anwendung (Raw)
Hinzufügen von uniqueinstanceraw zur Uses-Klausel.
Aufruf der InstanceRunning-Funktion: True wird zurückgegeben, falls bereits eine Instanz läuft.
Es gibt zwei Varianten:
1. Ohne Argumente:
- UniqueInstance nutzt den Namen des Executables um dieses zu identifizieren. Parameter werden nicht übergeben.
2. Mit zwei Argumenten:
- Identifier: Identifizierung der Anwendung
- SendParameters(default = false): Sendet vor dem beenden die ggf. übergebenen Parameter an die bereits laufende Instanz.
Remarks
- Tested with win32 (XP SP2) and Linux (Ubuntu Feisty).
- Version 0.2 requires fpc 2.2.0
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).Not more true since version 0.2- If you put two TUniqueInstance components in the same application with the same identifier your application won't 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 an 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
History
- 02/10/07 - Version 0.2
- Based in fpc 2.2.0
- Implemented parameter reception under unix
- General optimizations and code clean up
- 16/12/06 - Initial release. See my blog to know how it began.
Author
Luiz Américo Pereira Câmara
License
Modified LGPL
Download
Version 0.2: Lazarus CCR sourceforge.
