Dial_Version (function reference)

By October 1, 2019 October 13th, 2019 Online Help, Troi Dialog Plug-in
Troi Dialog Plug-in for FileMaker Pro

Dial_Version

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

SyntaxFunction badge

Dial_Version ( switches )

Parameters

switchesdetermine the behaviour of the function

Switches

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 = not registered; 1 = registered
-UnregisterPluginsets the registration state of the plug-in to unregistered, returns 0

If you leave the switches 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 switches parameter. It is either a:

-GetVersionString:
If you asked for the version string it will return for example “Troi Dialog Plug-in 8.0”.
-GetVersionNumber:
If you asked for the version number it returns the version number of the plug-in x1000. For example version 7.5.1 will return number 7510.
-ShowFlashDialog:
This will show the flash dialog and then return the error code 0.
-GetRegistrationState:
returns 0 = the plug-in is not registered ; 1 = the plug-in is registered.

Originated in

Troi Dialog Plug-in 1.2

Compatibility

FileMaker Pro 14 to 18

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.

Example

Set Variable [ $Result; Dial_Version ( "" ) ]

will for example return “Troi Dialog Plug-in 8.0”.

Example 2

Dial_Version ( "-GetVersionNumber" )

will return 7510 for version 7.5.1

Dial_Version ( "-GetVersionNumber" )

will return 5501 for version 5.5b1

Dial_Version ( "-GetVersionNumber" )

will return 8000 for version 8.0

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

Related functionFunction badge

Dial_VersionAutoUpdate

Related topics

Troi Dialog Plug-in online help (overview)


Online Help Page for Troi Dialog Plug-in for 14 to 18 –> Dial_Version (dialp9001) 2019-1013 20:02:12