Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 7.0   7.1   7.2   7.3   7.4   7.5   8.0   8.1   8.2   8.3    Statistic  


Writes text to the dongle.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
MatrixDongle 5.2 Yes Yes Yes Yes No

MBS( "MatrixDongle.WriteText"; UserCode; Text { ; Encoding; Pos; DongleNumber; PortNumber } )


Parameter Description Example value
UserCode This is your personal UserCode and must correspond with the internal UserCode from the dongle.
Text The text to write. "Hello World"
Encoding Optional
The text encoding for text parameter.
Default is UTF-8.
Possible encoding names: ANSI, Arabic-Mac, Arabic-Win, Baltic-Win, CentralEurope-Mac, ChineseSimp-Mac, ChineseSimp-Win, ChineseTrad-Mac, ChineseTrad-Win, Cyrillic-Mac, Cyrillic-Win, EasternEurope-Win, Greek-Mac, Greek-Win, Hebrew-Mac, Hebrew-Win, ISO-8859-1, ISO-8859-2, ISO-8859-3, ISO-8859-4, ISO-8859-5, ISO-8859-6, ISO-8859-7, ISO-8859-8, ISO-8859-9, ISO-8859-15, Korean-Johab, Korean-Mac, Korean-Win, Latin1, Mac, Native, ShiftJIS-Mac, ShiftJIS-Win, Turkish-Mac, Turkish-Win, UTF-8, DOS or Windows. Pass native to use the native encoding of the current platform.
Pos Optional
The position to write at. This value is in 4 byte data words, so for 12 bytes offset pass 3.
DongleNumber Optional
This is the dongle number when several dongles are plugged in one after the other. The maximum number of dongles available can be determined via the MatrixDongle.Count function.
A maximum of 99 dongles can be connected to the LPT port and a maximum of 127 dongles to the USB connection.
The plugin uses 1 if you don't pass this parameter.
PortNumber Optional
With LPT dongles, this is the number of the LPT port to which the dongles are connected. With LPT dongles, the port number must be between 1 and 3. Example: 1 for LPT1, 2 for LPT2 or 3 for LPT3.
With USB, this parameter must be 85.
This variable is ignored with network calls.
Default for MBS Plugin is 85 for USB.


Returns OK or error.


Writes text to the dongle.

See also

Example Databases

MatrixDongle.WriteHex   -   MediaLibraryBrowser.getMediaLibraries

Feedback: Report problem or ask question.

MBS Xojo blog