Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides
New in version: 5.4   6.0   6.1   6.2   6.3   6.4   6.5   7.0   7.1   7.2    Statistic  

Files.SetFinderLabel

Sets the Finder label.

Component: Files
Version: 6.2
Mac OS X: Yes
Windows: No
Server: Yes
FileMaker Cloud: No

MBS( "Files.SetFinderLabel"; Path; Label )

Parameters

Parameter Description Example value
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


Files.SetCreationDate   -   Files.SetHidden

Feedback: Report problem or ask question.




Links
MBS Real Studio PDF Plugins - Besuchen Sie die JUZ Nickenich Webseite