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:
12.2
12.3
12.4
12.5
13.0
13.1
13.2
13.3
13.4
13.5
Statistic
FMM
Blog
Files.SetFinderLabel
Sets the Finder label.
Component |
Version |
macOS |
Windows |
Linux |
Server |
iOS SDK |
Files
|
6.2 |
✅ Yes |
❌ No |
❌ No |
✅ Yes, on macOS |
❌ No |
MBS( "Files.SetFinderLabel"; Path; Label )
More
MBS(
"Files.SetFinderLabel"; /* Sets the Finder label. */
$Path; /* The native path to the file.e.g. "/Users/cs/Desktop/test.txt" */
$Label) /* The new label number.
0 = no label
1 to 7 give different colors.e.g. 1 */
Less
Parameters
Parameter |
Description |
Example |
Path |
The native path to the file. |
"/Users/cs/Desktop/test.txt" |
Label |
The new label number.
0 = no label
1 to 7 give different colors. |
1 |
Result
Returns OK or error.
Description
Sets the Finder label.
Value is from 0 to 7. Zero is no label. Numbers 1 to 7 are mapped to colors and tags.
Currently the list is 1 = gray, 2 = green, 3 = purple, 4 = blue, 5 = yellow, 6 = red, 7 = orange.
Please use Files.SetTagNames to set tag names if needed.
This function requires a native path. Use Path.FileMakerPathToNativePath to convert a FileMaker path to a native path if required. If you like to have the user choose the path, you can use FileDialog functions.
For Server be aware that server has limited permissions and may not be able to access all files on a computer.
Examples
Set color to green:
MBS("Files.SetFinderLabel"; "/Users/cs/Desktop/test.rtf"; 2)
See also
Blog Entries
This function checks for a license.
Created 17th May 2016, last changed 29th August 2016
Files.SetFileExtensionHidden
-
Files.SetHidden