home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / graphics / ba / tvxsamp / readme.txt < prev    next >
Text File  |  1997-09-23  |  5KB  |  151 lines
  1. An MFC sample that connects to and controls TV Viewer.
  2.  
  3. Summary
  4. =======
  5. TVXSamp is a Microsoft(R) Foundation Classes (MFC) application that 
  6. connects to and controls an instance of TV Viewer. The sample has a 
  7. single dialog box with buttons you can click to test its functionality. 
  8. On startup, TVXSamp gets a reference to a running instance of 
  9. TV Viewer. It uses this reference to call methods of the TV Viewer 
  10. dispatch interface, ITVViewer. 
  11.  
  12. For more information, see the TV Viewer and Creating TV Viewer 
  13. Controls topics in the Broadcast Architecture Programmer's Reference.
  14.  
  15. More Information
  16. ================
  17. The following information describes the TVXSamp sample.
  18.  
  19.  
  20. Requirements
  21. -----------------------------
  22. TVXSamp.exe must be run on a computer running the 
  23. Microsoft(R) Windows(R) 98 operating system with the TV Viewer 
  24. components installed. You should start TV Viewer before running 
  25. TVXSamp.exe.
  26.  
  27. TVXSamp.exe must be compiled using the 
  28. Microsoft(R) Visual C++(R) development system version 5.0 
  29. with MFC and Microsoft Active Template Library (ATL). 
  30.  
  31. You must configure your environment before 
  32. compiling TVXSamp.exe. First, make sure that 
  33. the environment variable INCLUDE points to the 
  34. Visual C++ Include directory, the ATL include directory,
  35. and the MFC Include directory. Similarly, make sure 
  36. the environment variable LIB points to the 
  37. Visual C++ Lib directory and the MFC Lib directory.
  38.  
  39. To Compile TVXSamp
  40. ------------------
  41. From the command prompt, use the following command:
  42.  
  43. nmake
  44.  
  45. For make options, see the makefile header comments.
  46.  
  47.  
  48. To Run TVXSamp
  49. --------------
  50. You must start TV Viewer before you run TVXSamp.exe. Otherwise, 
  51. TVXSamp cannot connect to TV Viewer, and a run-time error occurs.
  52.  
  53. Start TVXSamp.exe either from the command line by typing 
  54.  
  55. TVXSamp
  56.  
  57. or by double-clicking the TVXSamp icon in Windows Explorer. 
  58.  
  59. A dialog box appears, containing the following buttons:
  60.  
  61. Toggle TV Mode
  62.     Toggles TV Viewer between full screen and desktop mode.
  63.  
  64. Tune to TV Config
  65.     Tunes TV Viewer to the TV Config channel, 1.
  66.  
  67. Tune Back to Previous Channel
  68.     Tunes TV Viewer to the previous channel. This is the same 
  69.     functionality as a Back button in a Web browser.
  70.  
  71.  
  72. TVXSamp Files
  73. =============
  74.  
  75. Tvdisp.h
  76.     This is the header file for the TV Viewer dispatch interface. 
  77.     It is created from Tvdisp.odl.
  78.  
  79. TVXSamp.h
  80.     This is the main header file for the application. It includes 
  81.     other project specific headers (including Resource.h) and 
  82.     declares the CTVXSampApp application class.
  83.  
  84. TVXSamp.cpp
  85.     This is the main application source file that contains the 
  86.     application class CTVXSampApp.
  87.  
  88. TVXSamp.rc
  89.     This is a listing of all of the Microsoft Windows resources that 
  90.     the program uses. It includes the icons, bitmaps, and cursors that
  91.     are stored in the Res subdirectory. This file can be directly 
  92.     edited in Microsoft(R) Developer Studio.
  93.  
  94. Res\TVXSamp.ico
  95.     This is an icon file that is used as the application's icon. This
  96.     icon is included by the main resource file TVXSamp.rc.
  97.  
  98. Res\TVXSamp.rc2
  99.     This file contains resources that are not edited by Microsoft 
  100.     Developer Studio. You should place all resources that the 
  101.     resource editor cannot edit in this file.
  102.  
  103. TVXSamp.reg
  104.     This is an example .reg file that shows you the kind of 
  105.     registration settings the framework sets for you. You can use 
  106.     this as a .reg file to go along with your application.
  107.  
  108. TVXSamp.odl
  109.     This file contains the Object Description Language source code for 
  110.     the type library of your application.
  111.  
  112. TVXSamp.clw
  113.     This file contains information used by ClassWizard to edit existing
  114.     classes or add new classes. ClassWizard also uses this file to store
  115.     information needed to create and edit message maps and dialog data
  116.     maps and to create prototype member functions.
  117.  
  118.  
  119. /////////////////////////////////////////////////////////////////////////////
  120.  
  121. AppWizard creates one dialog box class and Automation proxy class:
  122.  
  123. TVXSampDlg.h, TVXSampDlg.cpp -- the dialog
  124.     These files contain your CTVXSampDlg class. This class defines
  125.     the behavior of your application's main dialog box. The dialog 
  126.     box's template is in the TVXSamp.rc file, which can be edited 
  127.     in Microsoft Developer Studio.
  128.  
  129. DlgProxy.h, DlgProxy.cpp -- the Automation object
  130.     These files contain your CTVXSampDlgAutoProxy class. This class
  131.     is called the "Automation proxy" class for your dialog box, because 
  132.     it takes care of exposing the Automation methods and properties 
  133.     that Automation controllers can use to access your dialog box. 
  134.     These methods and properties are not exposed from the dialog box
  135.     class directly, because in the case of a modal-dialog-box-based MFC 
  136.     application it is cleaner and easier to keep the Automation 
  137.     object separate from the user interface.
  138.  
  139. /////////////////////////////////////////////////////////////////////////////
  140.  
  141. Other standard files:
  142.  
  143. StdAfx.h, StdAfx.cpp
  144.     These files are used to build a precompiled header (PCH) file
  145.     named TVXSamp.pch and a precompiled types file named StdAfx.obj.
  146.  
  147. Resource.h
  148.     This is the standard header file, which defines new resource 
  149.     identifiers. Microsoft Developer Studio reads and updates this 
  150.     file.
  151.