Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: Apple Guide Complete / Part 3 - Integrating Guide Files

Chapter 9 - Apple Guide API / Determining Which Guide Files Are Available

AGGetAvailableDBTypes
Use the AGGetAvailableDBTypes function to determine the types of guide files that are available in the current application's Help menu.
UInt32 AGGetAvailableDBTypes(void);
DESCRIPTION
The AGGetAvailableDBTypes function returns a collection of bit flags that indicate the types of guide files that are available in the current application's Help menu:
enum AGDBTypeBit
{
   kAGDBBitAny          = 0x00000001,/*one or more guide */
                                     /* files are present*/
   kAGDBTypeBitHelp     = 0x00000002,/*Help guide file*/
   kAGDBTypeBitTutorial              /*Tutorial guide */
                        = 0x00000004,/* file*/
   kAGDBTypeBitShortcuts             /*Shortcuts guide */
                        = 0x00000008,/* file*/
   kAGDBTypeBitAbout    = 0x00000010,/*About guide file*/
   kAGDBTypeBitOther    = 0x00000080/*Other guide file*/
};
The AGGetAvailableDBTypes function returns

kAGDBBitAny if one or more guide files are present
kAGDBTypeBitHelp if a Help guide file is present
kAGDBTypeBitTutorial if a Tutorial guide file is present
kAGDBTypeBitShortcuts if a Shortcuts guide file is present
kAGDBTypeBitAbout if an About guide file is present
kAGDBTypeBitOther if an Other guide file is present
0 if no guide files are present

SEE ALSO
To count the number of guide files of a particular type, use the AGFileGetDBCount function, described next. To get the file system specification record for a guide file, use the AGFileGetIndDB function, as described on page 9-10.