home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / com / tutsamp / apputil / apputil.txt < prev    next >
Encoding:
Text File  |  1997-08-30  |  2.9 KB  |  73 lines
  1.  
  2. APPUTIL - Application Utility Library
  3.  
  4.  
  5. SUMMARY
  6. =======
  7.  
  8. The APPUTIL library provides utility classes and functions that are
  9. useful for making simple C++ Win32 Windows applications. APPUTIL is
  10. provided as part of the Win32 COM Tutorial code samples.
  11.  
  12. For functional descriptions and a tutorial code tour of APPUTIL, see the
  13. Code Tour section in APPUTIL.HTM. For details on setting up the
  14. programmatic usage of APPUTIL, see the Usage section in APPUTIL.HTM. To
  15. read APPUTIL.HTM, run TUTORIAL.EXE in the main tutorial directory and
  16. click the APPUTIL lesson in the table of lessons. You can also achieve the
  17. same thing by clicking the APPUTIL.HTM file after locating the main
  18. tutorial directory in the Windows Explorer.
  19.  
  20. For details on setting up your system to build and test the code samples
  21. in this COM Tutorial series, see TUTORIAL.HTM. The supplied MAKEFILE is
  22. Microsoft NMAKE-compatible. To create a debug build, issue the NMAKE
  23. command in the Command Prompt window.
  24.  
  25. Usage
  26. -----
  27.  
  28. APPUTIL.LIB is meant to be statically linked to modules (.EXEs or .DLLs)
  29. that use it. You include APPUTIL.H in the module that uses features of
  30. APPUTIL.LIB. You must also include APPUTIL.LIB in the LINK command of
  31. your application's makefile. For an example of the use of APPUTIL.LIB,
  32. see the READTUT code sample.
  33.  
  34. Classes
  35. -------
  36.  
  37. The classes provided are: CVirWindow, CVirDialog, CAboutBox, CDelayBox,
  38. CMsgBox, CMsgLog, CSendLog, and CThreaded.
  39.  
  40. Functions
  41. ---------
  42.  
  43. The functions provided are: WindowProc, DialogProc, AnsiToUc, UcToAnsi,
  44. DComOk, lRandom, CreateColorScalePalette, PaintWindow, SkipAnsi,
  45. FileExist, MakeFamilyPath, GetExeName, CmdExec, DelayBox, ErrorBox,
  46. GetErrorMsg, HrMsg, HrMsgId, ReadHelp, ReadTutorial, GoWeb, ReadSource,
  47. GetErrorMsg, and OutputDebugFmt.
  48.  
  49. There are also a series of A_ ANSII versions of COM/OLE service helper
  50. functions. The A_ functions are used in conjunction with a matching
  51. series of macros in APPUTIL.H to permit compilation of the code samples
  52. under both ANSII (default) and UNICODE. These macros and matching
  53. A_ functions are for service calls that only accept Unicode string
  54. parameters. For example, the standard StgIsStorageFile function
  55. only accepts a Unicode string. When compiling a sample for ANSII
  56. (ie, UNICODE is not defined), a macro substitutes any StgIsStorageFile
  57. calls into A_StgIsStorageFile calls. A_StgIsStorageFile is implemented
  58. here in APPUTIL. A_StgIsStorageFile takes the input ANSII string
  59. that is passed and converts it into a Unicode string prior to making a
  60. call to the actual StgIsStorageFile function.
  61.  
  62.  
  63. FILES
  64. =====
  65.  
  66. File          Description
  67.  
  68. APPUTIL.TXT   This file.
  69. MAKEFILE      The generic Win32 makefile for this APPUTIL library.
  70. APPUTIL.H     The include file for the APPUTIL library. Contains the
  71.               class declarations and function prototypes.
  72. APPUTIL.CPP   The main implementation file for APPUTIL.
  73.