 |
TrFile_SetDefaultCreator |
Specifies the file creator to be used when creating a new file. This creator will be used for subsequent calls to TrFile_CreateFile.
Syntax
TrFile_SetDefaultCreator ( switches ; Creator )
Parameters
| switches | not used, reserved for future use. Leave blank or put "-Unused" |
| Creator | The Creator of a file is a 4 character code used to designate the application that created a file. For example: use "ttxt" to create a SimpleText text file |
Returned Result
Data type returned
Error code
Result
This function returns an error code.
Originated in
Troi File Plug-in 1.0
Compatibility
FileMaker Pro 16 to FileMaker Pro 2023
Considerations
See also the function “TrFile_CreateFile” to create a new empty file.
macOS only. Note that Creator codes and FileTypes are deprecated in macOS, but still supported by the plug-in. Ignored on Windows.
Starting from v3.0.5: if you use “” as creator no creator is used for newly created files.
Example
We assume that in your FileMaker file the following fields are defined:
gErrorCode Global, number
gFilePath Global, text
textField textgFilePath should contain the path to an existing file, for example “D:\Hello.TXT” (Windows) or “Disk1:Hello” (Mac). TextField contains the text you want to write. In a script add the following scriptsteps:
Set Field [ gErrorCode ; TrFile_SetDefaultFileSpec ( gFilePath ) ]
Set Field [ gErrorCode ; TrFile_SetDefaultCreator ( "ttxt" ) ]
Set Field [ gErrorCode ; TrFile_SetDefaultType ( "TEXT" ) ]
Set Field [ gErrorCode ; TrFile_SetContents ( "-Encoding=ASCII_Windows" ; textField ) ]This will set the default file to your file with a SimpleText FileType and Creator. Then the text is written to the file.
Used in example files
CreateFile.fmp12
Attribute.fmp12
Related functions
| TrFile_CreateFile |
| TrFile_SetDefaultType |
Related topics
Troi File Plug-in online help (overview)
