Monkeybread Software - MBS FileMaker Plugin: MatrixDongle.WriteText

Topics All MacOS (Only) Windows (Only) Linux (Only, Not) iOS (Only, Not)
Components Crossplatform Mac & Win Server Client Old Deprecated Guides Examples Videos
New in version: 9.3 9.4 9.5 10.0 10.1 10.2 10.3 10.4 10.5 10.6 Statistic FMM Blog

MatrixDongle.WriteText

Writes text to the dongle.

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

Deprecated

This function was deprecated.

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

Parameters

Parameter Description Example Flags

UserCode This is your personal UserCode and must correspond with the internal UserCode from the dongle.

Text The text to write. "Hello World"

Encoding The text encoding for text parameter.
Default is UTF-8.
Possible encoding names: ANSI, ISO-8859-1, Latin1, Mac, Native, UTF-8, DOS, Hex, Base64 or Windows. More listed in the FAQ. UTF8 Optional

Pos The position to write at. This value is in 4 byte data words, so for 12 bytes offset pass 3. 0 Optional

DongleNumber 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. 1 Optional

PortNumber 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. 85 Optional

Parameter	Description	Example	Flags
UserCode	This is your personal UserCode and must correspond with the internal UserCode from the dongle.
Text	The text to write.	"Hello World"
Encoding	The text encoding for text parameter. Default is UTF-8. Possible encoding names: ANSI, ISO-8859-1, Latin1, Mac, Native, UTF-8, DOS, Hex, Base64 or Windows. More listed in the FAQ.	UTF8	Optional
Pos	The position to write at. This value is in 4 byte data words, so for 12 bytes offset pass 3.	0	Optional
DongleNumber	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.	1	Optional
PortNumber	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.	85	Optional

Result

Returns OK or error.

Description

Writes text to the dongle.

Example Databases

MatrixDongle

Created 1st August 2015, last changed 31st July 2020

MatrixDongle.WriteHex - MediaLibraryBrowser.getMediaLibraries