Futurebasic/Language/Reference/finderinfo

= FINDERINFO function =

Function
✔ Appearance ✔ Standard ✔ Console

Syntax
Move all waiting items to arrays or simple variables

Find out how many items are waiting to be picked up

Pick up an indexed item from the list

Gather a list of file spec records

Clear the list

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  function to determine which document file(s) were involved, and whether they should be opened or printed.

You should call  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  event is sent from another application or when the user drags a file onto the icon of your running application.

•  - The result of the   function is one of the following:

Image was here.

•  - This variable is used to send a value to and receive a result from

Image was here.

The parameters for  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.

Image was here.

Note: Before your application can support Finder-launched documents, you need to set up certain special resources ( and  ) in your application's resource fork. Also,  will not work unless the "High-level event aware" flag is turned on in your application's   resource #-1. See the "Finder Interface" chapter in Macintosh Toolbox Essentials for more information.