Legacy Document

Inside Macintosh: Files /

Chapter 3 - Standard File Package / Using the Standard File Package

Using the Original Procedures

The Standard File Package still recognizes all procedures available before system software version 7.0 (SFGetFile, SFPutFile, SFPGetFile, and SFPPutFile). It displays the new interface for all applications that don't customize the dialog boxes in incompatible ways (that is, applications that specify both the dialog hook and the modal-dialog filter pointers as NIL and that specify no alternative dialog ID).

When the Standard File Package can't use the enhanced dialog box layout because an application customized the dialog box with the earlier procedures, it nevertheless makes some changes to the display:

• It changes the label of the Drive button to Desktop and makes the desktop the root of the display.
• It moves the volume icon slightly to the right, to make room for selection highlighting around the display list field.

If, however, a customized dialog box has suppressed the file display list (by specifying coordinates outside of the dialog box), the Standard File Package uses the earlier interface, on the assumption that the dialog box is designed for volume selection.

If you need to use the procedures available before system software version 7.0, you need to be aware of a number of differences between those procedures and the enhanced procedures. These are the most important differences:

• The original procedures do not recognize some pseudo-items under previous system software versions. For example, the pseudo-item sfHookLastCall is not used
  before version 7.0. See the comments under "Constants" in "Summary of the Standard File Package" (beginning on page 3-60) for information on which pseudo-items are universally available.
• The original standard file reply record (type SFReply) returns a working directory reference number, not a volume reference number. Typically, you should immediately convert that number to a volume reference number and directory ID using GetWDInfo or PBGetWDInfo. Then close the working directory by calling CloseWD or PBCloseWD. For details on these functions, see the chapter "File Manager" in this book.
• Dialog hook functions used with the original procedures are not passed a
  myDataPtr parameter.