Futurebasic/Language/Reference/finderinfo

FINDERINFO function FINDERINFO Function ✔ Appearance ✔ Standard ✔ Console Syntax Move all waiting items to arrays or simple variables countVar = maxAcceptableentries action = ¬   FINDERINFO(countVar%, nameVar$, typeVar&, dirRefNumVar%) Find out how many items are waiting to be picked up countVar = 0 action = ¬   FINDERINFO(countVar%, nameVar$, typeVar&, dirRefNumVar%) Pick up an indexed item from the list countVar = negativeIndex action = ¬   FINDERINFO(countVar%, nameVar$, typeVar&, dirRefNumVar%) Gather a list of file spec records countVar = maxAcceptableentries action = ¬   FINDERINFO(countVar%, @FSSpec[(array)],@OSType&[(array)], dirRefNumVar%) Clear the list FN CLEARFINDERINFO Description If the user launched your application by double-clicking a document icon, or by dragging document icon(s) to your application's icon, or by selecting document icon(s) and then selecting "Open" or "Print" from the Finder's "File" menu, then you can use the FINDERINFO function to determine which document file(s) were involved, and whether they should be opened or printed. You should call FINDERINFO once, soon after your program starts. You should also check during null events to see if additional files have been added to the list. This can take place when an _openDoc event is sent from another application or when the user drags a file onto the icon of your running application. • action - The result of the FINDERINFO function is one of the following: Image was here. • countVar - This variable is used to send a value to and receive a result from FINDERINFO Image was here. The parameters for FINDERINFO are used to both send and receive values. In order to send a value of "1" for the count, you must first set the variable, then check it on return. count% = 0 action = FINDERINFO(count%,fName$,fType&,vRefNum%)PRINT "There are" count%" files in the queue." Image was here. Note: Before your application can support Finder-launched documents, you need to set up certain special resources (BNDL and FREF) in your application's resource fork. Also, FINDERINFO will not work unless the "High-level event aware" flag is turned on in your application's SIZE resource #-1. See the "Finder Interface" chapter in Macintosh Toolbox Essentials for more information.