Actr_Version (function reference)

Activator Plug-in for FileMaker Pro


Use this function to see which version of the plug-in is loaded.
Note: this function is also used to register the plug-in.

SyntaxFunction badge

Actr_Version ( switches )


switchesdetermine the behavior of the function


switches can be one of this:

-GetVersionStringthe version string is returned (default)
-GetVersionNumberreturns the version number of the plug-in
-ShowFlashDialogshows the Flash Dialog of the plug-in (returns 0)
-GetPluginInstallPathreturns the path where the plug-in is installed
-GetRegistrationStateget the registration state of the plug-in: 0 = unregistered ; 1 = registered
-UnregisterPluginsets 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



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:

If you asked for the version string it will return for example “Troi Activator Plug-in 4.5”

If you asked for the version number it returns the version number of the plug-in x1000. For example version 4.5 will return number 4500.

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


FileMaker Pro 12 to 16


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.


Actr_Version ( "" )

will for example return “Activator Plug-in 4.5”

Example 2

Actr_Version ( "-GetVersionNumber" )

will return 4500 for version 4.5.

Actr_Version ( "-GetVersionNumber" )

will return 4001 for version 4.0b1

Actr_Version ( "-GetVersionNumber" )

will return 3120 for version 3.1.2

So for example to use a feature introduced with version 4.5 test if the result is equal to or greater than 4500.

Related functionFunction badge


Related topics

Activator Plug-in online help (overview)

Online Help Page for Activator Plug-in for 12 to 16 –> Actr_Version (actrp9001) 2017-0823 11:44:43