 |
Actr_Version |
Use this function to see which version of the plug-in is loaded.
Note: this function is also used to register the plug-in.
Syntax
Actr_Version ( switches )
Parameters
| switches | determine the behavior of the function |
Switches
switches can be one of this:
| -GetVersionString | the version string is returned (default) |
| -GetVersionNumber | returns the version number of the plug-in |
| -ShowFlashDialog | shows the Flash Dialog of the plug-in (returns 0) |
| -GetPluginInstallPath | returns the path where the plug-in is installed |
| -GetRegistrationState | get the registration state of the plug-in: 0 = unregistered ; 1 = registered |
| -UnregisterPlugin | sets the registration state of the plug-in to unregistered |
If you leave the parameter empty the version string is returned.
Returned Result
Data type returned
Text
Result
The function returns ? if this plug-in is not loaded. If the plug-in is loaded the result depends on the input parameter. It is either a:
VersionString:
If you asked for the version string it will return for example “Troi Activator Plug-in 6.0”
VersionNumber:
If you asked for the version number it returns the version number of the plug-in x1000. For example version 6.0 will return number 6000.
ShowFlashDialog result:
This will show the flash dialog and then return the error code 0.
GetRegistrationState result:
0 = the plug-in is not registered ; 1 = the plug-in is registered.
Originated in
Activator Plug-in 1.2
Compatibility
FileMaker Pro 16 to 19
Considerations
IMPORTANT Always use this function to determine if the plug-in is loaded. If the plug-in is not loaded use of external functions may result in data loss, as FileMaker will return an empty field to any external function that is not loaded.
See the Version.fmp12 example file.
Example
Actr_Version ( "" )will for example return “Activator Plug-in 8.0”
Example 2
Actr_Version ( "-GetVersionNumber" )will return 8000 for version 8.0.
Actr_Version ( "-GetVersionNumber" )will return 7001 for version 7.0b1
Actr_Version ( "-GetVersionNumber" )will return 3120 for version 3.1.2
So for example to use a feature introduced with version 7.0 test if the result is equal to or greater than 7000.
Used in example file
Version.fmp12
Related function
| Actr_VersionAutoUpdate |
Related topics
Activator Plug-in online help (overview)
