Components | All | New | MacOS | Windows | Linux | iOS | ||||
Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old |
FM.MouseWheelScriptTrigger
Installs a script trigger for mouse wheel.
Component | Version | macOS | Windows | Linux | Server | iOS SDK |
FM | 6.3 | ✅ Yes | ✅ Yes | ❌ No | ❌ No | ❌ No |
MBS( "FM.MouseWheelScriptTrigger"; FileName; ScriptName { ; MinDelay; IgnoreRectangleX; IgnoreRectangleY; IgnoreRectangleW; IgnoreRectangleH } ) More
Parameters
Parameter | Description | Example | Flags |
---|---|---|---|
FileName | The file name for the script. | Get(Filename) | |
ScriptName | The name of the script to trigger. Can be empty to disable feature. |
"WheelScriptTrigger" | |
MinDelay | The minimum delay between script triggers. Default is 1. Could be 0.5 for a quicker reaction. |
1 | Optional |
IgnoreRectangleX | Available in MBS FileMaker Plugin 7.1 or newer. The X position of the rectangle where scroll action is ignored if the mouse is inside. Relative to the parent window. Default is -1 to have no such rectangle. Rectangle area is Windows only. |
135 | Optional |
IgnoreRectangleY | Available in MBS FileMaker Plugin 7.1 or newer. The Y position of the rectangle where scroll action is ignored if the mouse is inside. Relative to the parent window. Default is -1 to have no such rectangle. |
55 | Optional |
IgnoreRectangleW | Available in MBS FileMaker Plugin 7.1 or newer. The width of the rectangle where scroll action is ignored if the mouse is inside. Relative to the parent window. Default is -1 to have no such rectangle. |
400 | Optional |
IgnoreRectangleH | Available in MBS FileMaker Plugin 7.1 or newer. The height of the rectangle where scroll action is ignored if the mouse is inside. Relative to the parent window. Default is -1 to have no such rectangle. |
500 | Optional |
Result
Returns OK or error.
Description
Installs a script trigger for mouse wheel.If you like to have a script triggered to switch records on Windows with mouse wheel, you can use this function.
The script parameter is the delta on mouse wheel usage. 120 is one tick down and negative value means movement up.
The script is called at most once every second (by default).
Turn off by calling again with empty script name. This setting is global, so you may just install once in start script.
Add option to ignore a rectangle for plugin version 7.1.
Implemented for Mac and FileMaker 16 or newer with MBS Plugin 9.1.
With plugin version 6.0 or newer the script name can be a script ID number. In that case the plugin queries the script name for the given script ID. This allows to call scripts by ID and avoid problems if scripts are later renamed.
Notice: FileMaker 19.2 adds a fmplugin extended privileges. If you have such an extended privileges to allow the plugin to trigger scripts, you need to grant permissions for it. If such a privilege is not defined, the plugin is allowed to trigger scripts. See FileMaker product documentation for details.
Examples
Installs trigger:
MBS("FM.MouseWheelScriptTrigger"; Get(FileName); "MouseTrigger")
Sample MouseTrigger script to move between records:
If [Get ( ActiveFieldName ) = ""]
Set Variable [$r; Value:Round(Get(ScriptParameter) / 120; 0)]
Go to Record/Request/Page [No dialog; Get ( RecordNumber ) + $r]
// Set Variable [$r; Value:MBS("Log"; "MouseWheel " & $r)]
End If
See also
Release notes
- Version 9.1
- Implemented FM.MouseWheelScriptTrigger for MacOS to navigate through records with mouse wheel.
- Version 7.1
- Added ignore rectangle parameters for FM.MouseWheelScriptTrigger function.
Example Databases
Blog Entries
- Customize your FileMaker solution
- Neues MBS FileMaker Plugin 9.1
- MBS FileMaker Plugin 9.1 - More than 5700 Functions In One Plugin
- MBS FileMaker Plugin, version 9.1pr3
- Scroll through records with mouse wheel on MacOS
- MBS FileMaker Plugin, version 7.1pr1
- MBS FileMaker Plugin, version 6.3pr1
This function checks for a license.
Created 27th May 2016, last changed 18th February 2019
