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 / conclien / conclien.txt < prev    next >
Text File  |  1997-08-05  |  4KB  |  81 lines
  1.  
  2. CONCLIEN - Client of Connectable Components
  3.  
  4.  
  5. SUMMARY
  6. =======
  7.  
  8. The CONCLIEN sample creates and uses the connectable COBall COM object
  9. that is housed in the CONSERVE server as the DllSndBall component. The
  10. CONCLIEN client creates one COBall object and controls it through the
  11. IBall interface that the object exposes. CONCLIEN sets up a system timer
  12. to use IBall to periodically move the ball and obtain updates of data
  13. describing the COBall object's position, size, and color. It uses that
  14. data, obtained by calling the IBall::GetBall method, to display graphical
  15. snapshot images of the ball in the client's main window.
  16.  
  17. CONCLIEN also implements a COBallSink COM object and connects it to an
  18. appropriate connection point in the server's COBall object. In response to
  19. the system timer's WM_TIMER messages, which are sent periodically to the
  20. display window, CONCLIEN uses the IBall interface to move and paint images
  21. of the ball. COBall also sends notifications back to CONCLIEN, using the
  22. IBallSink interface, when the ball bounces off of a side of its bounding
  23. rectangle. CONCLIEN responds to these event notifications to produce a
  24. different sound when the ball collides with a Top, Side, or Bottom
  25. boundary of the display window.
  26.  
  27. For functional descriptions and a tutorial code tour of CONCLIEN, see the
  28. Code Tour section in CONCLIEN.HTM. For details on the external user
  29. operation of CONCLIEN, see both the Usage and Operation sections in
  30. CONCLIEN.HTM. To read CONCLIEN.HTM, run TUTORIAL.EXE in the main tutorial
  31. directory and click the CONCLIEN lesson in the table of lessons. You can
  32. also achieve the same thing by clicking the CONCLIEN.HTM file after
  33. locating the main tutorial directory in the Windows Explorer. See also
  34. CONSERVE.HTM in the main tutorial directory for more details on how
  35. CONSERVE works and exposes its services to CONCLIEN. You must build the
  36. CONSERVE DLL before building CONCLIEN. The makefile for CONSERVE
  37. automatically registers that server in the system registry, so you must
  38. build CONSERVE before attempting to run CONCLIEN.
  39.  
  40. For details on setting up your system to build and test the code samples
  41. in this COM Tutorial series, see TUTORIAL.HTM. The supplied MAKEFILE is
  42. Microsoft NMAKE-compatible. To create a debug build, issue the NMAKE
  43. command in the Command Prompt window.
  44.  
  45. Usage
  46. -----
  47.  
  48. CONCLIEN is an application that you can execute directly from Windows in
  49. the normal manner or from the Command Prompt window. No command line
  50. parameters are recognized by CONCLIEN.
  51.  
  52. The Win32 Beep function is used in this sample to produce ball bounce
  53. sounds of various frequencies. This works under Windows NT 4.0 and later.
  54. Under the Windows 95 operating system, the Win32 Beep function currently
  55. uses whatever is assigned in the Control Panel's Sound dialog for the
  56. default sound and thus ignores the frequency values passed to Beep. Under
  57. current releases of Windows 95, the sound will not be different when the
  58. ball collides with the top, bottom, or side of the display window.
  59.  
  60.  
  61. FILES
  62. =====
  63.  
  64. Files          Description
  65.  
  66. CONCLIEN.TXT   This file.
  67. MAKEFILE       The generic makefile for building the code sample
  68.                application of this tutorial lesson.
  69. CONCLIEN.H     The include file for the CONCLIEN application. Contains
  70.                class declarations, function prototypes, and resource
  71.                identifiers.
  72. CONCLIEN.CPP   The main implementation file for CONCLIEN.EXE. Has WinMain
  73.                and CMainWindow implementation, as well as the main menu
  74.                dispatching.
  75. CONCLIEN.RC    The application resource definition file.
  76. CONCLIEN.ICO   The application icon resource.
  77. SINK.H         The class declaration for the COBallSink class.
  78. SINK.CPP       Implementation file for the COBallSink class.
  79. GUIBALL.H      The class declaration for the CGuiBall C++ class.
  80. GUIBALL.CPP    Implementation file for the CGuiBall C++ class.
  81.