home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c480 / 21.ddi / README.TXT < prev    next >
Encoding:
Text File  |  1993-02-14  |  14.6 KB  |  380 lines
  1.                  README.TXT
  2.  
  3.               Release Notes for Microsoft (R) Visual Control Pack
  4.  
  5.                 Version 1.00
  6.  
  7.           (C) Copyright Microsoft Corporation, 1993
  8.  
  9. This document contains release notes for the Microsoft Visual Control Pack
  10. version 1.0. Information in this document is more current than that in the
  11. manuals or online Help.
  12.  
  13.      ********************************************************************
  14.      Read Part 1 - Software Installation Information - before installing.
  15.      ********************************************************************
  16.  
  17. ========
  18. Contents
  19. ========
  20.  
  21. Part    Description
  22. ----    -----------
  23.  1      Software Installation Information
  24.  
  25.  2      Custom Controls
  26.  
  27.  3      Visual Basic Samples
  28.  
  29.  
  30. Part 1: Software Installation Information
  31. =========================================
  32.  
  33. Before installing the Visual Control Pack version 1.0, you should make
  34. backup copies of all the distribution disks.
  35.  
  36. SETUP.EXE is a Windows application; that is, it is run from Windows
  37. rather than from the MS-DOS prompt.  SETUP.EXE will only run in Windows
  38. Standard or Enhanced mode.  It will not run in Real mode.  You can
  39. determine how Windows is configured on your computer by choosing About
  40. from the Help menu in the Program Manager.
  41.  
  42. To install the Visual Control Pack, use Program Manager or File
  43. Manager to start SETUP.EXE as you would any other Windows-based
  44. application.  For example, if you are installing from drive A:
  45.  
  46.     - From the Program Manager File menu, choose Run.
  47.  
  48.     - In the Run dialog box, type A:SETUP and choose OK.
  49.  
  50.     Or
  51.  
  52.     - From the File Manager, double-click on the SETUP.EXE file icon
  53.       on drive A.
  54.  
  55. Most of the files on these disks are compressed and must be expanded before
  56. they can be used.  For the Visual Control Pack to work properly, you must
  57. install the files using SETUP.EXE.  You cannot simply copy the files to
  58. your hard disk.
  59.  
  60. During setup, the Visual Control Pack installs the custom controls into
  61. your Windows system directory.  If you have custom controls with the same
  62. name as the custom controls included with the Visual Control Pack, then
  63. the Visual Control Pack installs the custom controls in your Visual Control
  64. Pack directory.
  65.  
  66.  
  67. Part 2: Custom Controls
  68. =======================
  69.  
  70. Installing Custom Controls
  71. --------------------------
  72. The Visual Control Pack installs custom controls in the Windows system
  73. directory.  If you previously installed the Visual Basic 1.0 Professional
  74. Toolkit, you may have old versions of controls in the \VB\VBX directory.
  75. You should remove any older versions of controls you may have on your
  76. machine.
  77.  
  78. VB.LIC
  79. ------
  80. Please make sure that the copy of VB.LIC in the \windows\system directory
  81. is the only one on your computer.  Otherwise, you may encounter problems
  82. loading the new custom controls.
  83.  
  84. If an older VB.LIC is being used, or you have a missing or incorrectly
  85. installed VB.LIC file, the following message appears when you try to add
  86. the custom control file to your project:
  87.  
  88.  "License file for custom control not found.  You do not have an
  89.   appropriate license to use this custom control in the design
  90.   environment."
  91.  
  92. Communications Control
  93. ----------------------
  94. Page    Section
  95. --------------------
  96. 116     Visual C++ Declaration for ComInput Function
  97.  
  98.     Declaration should be:
  99.     int FAR PASCAL ComInput(HWND hWnd, LPSTR lpData, int cbData);
  100.  
  101. 116     Visual C++ Declaration for ComOutput Function
  102.  
  103.     Declaration should be:
  104.     int FAR PASCAL ComOuput(HWND hWnd, LPSTR lpData, int cbData);
  105.  
  106.  
  107. Pen Controls (PENCNTRL.VBX) Update
  108. ----------------------------------------
  109.  
  110. The CPointerToVBType and VBTypeToCPointer functions are not necessary
  111. in Visual C++.  You can simply typecast the memory address, which is
  112. passed to the RcResult event, to a RCRESULT structure pointer.
  113.  
  114. Shipping PENWIN.DLL with Your Application
  115. -----------------------------------------
  116. PENWIN.DLL is a fully redistributable component of Windows for
  117. Pen Computing.  Because applications will seek to leverage the
  118. Pen API - Visual Basic controls in particular - PENWIN.DLL can
  119. be shipped with your application.  There are some considerations
  120. to keep in mind when shipping PENWIN.DLL with your application:
  121.  
  122. 1.  PENWIN.DLL functions ONLY under Windows 3.1.  It WILL NOT
  123.     WORK with Windows 3.0 because it functions only as an
  124.     installable device driver (a feature not present in Windows
  125.     3.0).
  126.  
  127. 2.  As with other redistributable components (such as COMMDLG.DLL
  128.     and the OLE libraries), it is the responsibility of the
  129.     application vendor to determine whether PENWIN.DLL has
  130.     already been installed (there is a GetSystemMetrics() call
  131.     for this) and to ensure that the version of PENWIN.DLL with
  132.     the latest version stamping is the one that is running. These
  133.     issues are the same for all redistributable components, and
  134.     further information is contained in the Windows SDK.
  135.  
  136. 3.  Unlike some of the other redistributable components, if your
  137.     application installs PENWIN.DLL for the first time, or
  138.     replaces the current version with a later one, Windows will
  139.     have to be restarted.  As an installable driver PENWIN.DLL
  140.     can be loaded only at Windows boot time.  Restarting Windows
  141.     can be accomplished via an ExitWindows() call or by simply
  142.     prompting the user to do so.
  143.  
  144.     NOTE:  To install PENWIN.DLL on a Windows 3.1 system follow the
  145.        directions listed in the Pen Sample section below.
  146.  
  147. 4.  PENWIN.DLL may be in either the \WINDOWS or the \WINDOWS\SYSTEM
  148.     directory.  The default will be \WINDOWS, but since Windows for Pen
  149.     Computing is an OEM product, Microsoft cannot completely control where
  150.     PENWIN.DLL is located on a particular machine.
  151.  
  152. To get a good feel for the Pen Windows controls, you are encouraged to
  153. use and experiment with the Pen sample application (PENSMPL.MAK).
  154.  
  155.  
  156. Part 3: Visual Basic Samples
  157. ============================
  158. Note:  These samples are only intended for Visual Basic 2.0.
  159.  
  160. Multimedia Sample
  161. -----------------
  162. This sample program illustrates the use of some of the device types
  163. supported by the Media Control Interface (MCI).  The four device 
  164. types used in this program are:
  165.  
  166.    Device Type     Description
  167.    -----------     -----------
  168.    MMMovie         Plays Multimedia movie files (*.mmm).
  169.    CDAudio         Plays audio discs from the CD-ROM drive.
  170.    Sequencer       Plays MIDI sequencer sound files (*.mid).
  171.    WaveAudio       Plays digitized waveform sound files (*.wav).
  172.  
  173. HARDWARE REQUIREMENTS:
  174. In order to access a CD-ROM drive or a sound card, the hardware,
  175. along with any supporting device drivers, need to be installed
  176. and configured for the machine.  The following table lists
  177. the hardware required for the MCI device types used in this
  178. program:
  179.  
  180.    Device Type     Hardware
  181.    -----------     --------
  182.    MMMovie         No extra hardware.  *See software requirements.
  183.    CDAudio         CD-ROM drive.
  184.    Sequencer       Sound card (e.g., Sound Blaster Pro)
  185.    WaveAudio       Sound card.
  186.  
  187. SOFTWARE REQUIREMENTS:
  188. In order to run the MCI application, Microsoft Windows with
  189. Multimedia Extensions 1.0, or Windows with Multimedia must be 
  190. installed.  The Multimedia Extensions include device drivers for
  191. the different types of MCI devices.
  192.  
  193. To access a specific MCI device type, the corresponding MCI device
  194. driver must be installed.  The following table list the device 
  195. drivers required for the MCI device types used in this program:
  196.  
  197.    Device Type     Device Driver
  198.    -----------     -------------
  199.    MMMovie         MCIMMP.DRV    *See note below.
  200.    CDAudio         MCICDA.DRV
  201.    Sequencer       MCISEQ.DRV
  202.    WaveAudio       MCIWAVE.DRV
  203.  
  204. The [mci] section of the SYSTEM.INI file contains a list of the
  205. installed MCI device types.  This is what your file would look
  206. like if all 4 of the above device types were installed:
  207.  
  208. [mci]
  209. CDAudio=mcicda.drv
  210. WaveAudio=mciwave.drv
  211. Sequencer=mciseq.drv
  212. MMMovie=mcimmp.drv
  213.  
  214. BACKGROUND:
  215. The MCI control provides a high-level interface for using 
  216. multimedia devices. Using the property settings of a control, you
  217. can determine the settings and the actions of a device.
  218.  
  219. The MCI control is also smart enough to know what action are 
  220. relevant for the current state of a device.  For example, if you 
  221. click on a "Pause" button while playing a movie, the "Play" 
  222. button is automatically re-enabled.
  223.  
  224. NOTE:
  225. If you are unable to run an animation movie (*.mmm file), make 
  226. sure the MCIMMP.DRV and MMP.DLL files are installed on your 
  227. machine.  To install the animation driver from Windows 3.1, run 
  228. the "Drivers" applet from the Control Panel, insert Disk 1 of the
  229. Visual Control Pack (the files MCIMMP.DR_ and MMP.DL_ are also in
  230. the C:\VCP subdirectory).  Select "Unlisted Driver", and accept
  231. "A:\" as the directory.  You will then be ready to use the
  232. animation features of the MCI control.
  233.  
  234. FILES:
  235.    ABOUTBOX.FRM.......The dialog box for the "About Box".
  236.    ANIMATE.FRM........Form for playing Multimedia Movie files.
  237.    CD.FRM.............The form for playing compact disc audio.
  238.    GLOBAL.BAS.........Global data types and declarations.
  239.    MCITEST.BAS........Global Subs and Functions.
  240.    MCITEST.FRM........The main form.
  241.    MCITEST.MAK........The MAKE file for the project.
  242.    MCITEST.MID........Sample MIDI sequencer file.
  243.    MCITEST.MMM........Sample Multimedia Movie file.
  244.    MCITEST.WAV........Sample waveform file.
  245.    OPENDLG.FRM........Form for holding the Common Dialog control.
  246.    WAVE.FRM...........Form for playing waveform and MIDI files.
  247.  
  248. TO RUN:
  249. In the Visual Basic environment (VB.EXE), you can load the files
  250. in this sample program by choosing Open Project from the File 
  251. menu, and selecting the MCITEST.MAK file.
  252.  
  253. Two additional files appear in the Project Window:
  254.  
  255.    MCI.VBX............MCI control.
  256.    CMDIALOG.VBX.......Common Dialog control.
  257.  
  258. PEN Sample
  259. ----------
  260. Note:  To run this sample you must have Windows for Pen Computing, 
  261.        or install the PENWIN.DLL file.  See below.
  262.  
  263. BRIEF DESCRIPTION of PEN SAMPLE PROGRAM:
  264. This sample program illustrates many uses of the Pen controls:
  265.   * the new On-Screen Keyboard control
  266.   * inking and displaying bitmaps on the new InkOnBitmap control
  267.   * handwriting recognition in both delayed and non-delayed mode
  268.   * recognition of gestures
  269.   * transfer of ink data between controls
  270.   * manipulation of the Recognition Context data structure
  271. and more.
  272.  
  273. The file PENAPI.TXT contains function and constant declarations
  274. for the entire set of Windows for Pen Computing API.
  275.  
  276. FILES:
  277.    DELAY.FRM.........Form for demonstrating Delayed Recognition.
  278.    DELAY.FRX.........The binary for DELAY.FRM.
  279.    EDITSUBF.FRM......Support Form for Gesture demonstration.
  280.    GESTFRM.FRM.......Form for demonstrating Custom Gestures.
  281.    INKFRM.FRM........Form for showing transfer of Ink data.
  282.    IOBFRM.FRM........Form demonstrating the Ink On Bitmap control.
  283.    IOBFRM.FRX........The binary for IOBFRM.FRM.
  284.    KEYBRD.FRM........Form for the On-Screen Keyboard Button demo.
  285.    KEYBRD.FRX........The binary for KEYBRD.FRM.
  286.    PENAPI.TXT........Pen function declarations and constants.
  287.    PENMAIN.FRM.......Main form.
  288.    PENMAIN.FRX.......The binary for MAIN.FRM.
  289.    PENSMPL.MAK.......The MAKE file for the project.
  290.    RCFRM.FRM.........Form demonstrating the Recognition Context.
  291.    GRAFPAPR.BMP......Bitmap for creating graph paper effect.
  292.    RULEPAPR.BMP......Bitmap for creating ruled paper effect.
  293.    SKBFACE.BMP.......Bitmap of default keyboard on SKB Button.
  294.    TRANSFRM.FRM......Form for demonstrating transfer of ink data.
  295.  
  296. TO RUN:
  297. After starting the Visual Basic environment (VB.EXE), you can load
  298. files in this sample program by choosing Open Project from the File
  299. menu and select the PENSMPL.MAK file.
  300.  
  301. Installing PENWIN.DLL:
  302. This procedure will result in a system that will let you run
  303. applications that contain Visual Basic BEdit, HEdit, InkOnBitmap,
  304. and SKB Button controls and call the Windows for Pen Computing APIs.
  305. You will not be able to perform handwriting recognition or draw ink
  306. on the screen. Microsoft Windows 3.1 is required.
  307.  
  308. SYSTEM.INI Changes
  309. The following items must be added or changed in your SYSTEM.INI
  310. file so that the pen extensions will work.  NOTE: Back up your old
  311. SYSTEM.INI file before proceeding.
  312.  
  313. 1.  In the "[boot]" section:
  314.       Add "penwindows" to the list of drivers after "drivers=".
  315.       For example:
  316.         drivers=mmsystem.dll penwindows
  317.  
  318. 2.  In the "[drivers]" section:
  319.       Add a new item "penwindows" and set it equal to the path to 
  320.       PENWIN.DLL.
  321.       For example:
  322.         penwindows=C:\WINDOWS\PENWIN.DLL
  323.  
  324. 3.  Restart Windows so the changes can take effect.
  325.  
  326. When Windows is restarted PENWIN.DLL will be loaded as an
  327. installed driver and you will be able to run applications
  328. containing Visual Basic BEdit, HEdit, InkOnBitmap, and SKB
  329. Button controls and call the Windows for Pen Computing APIs.
  330.  
  331. PicClip Sample
  332. --------------
  333. Program example using the PICCLIP.VBX control.
  334.  
  335. BRIEF DESCRIPTION:
  336. This sample program illustrates one of the many possible uses of
  337. the Picture Clipping control.
  338.  
  339. BACKGROUND:
  340. This sample application uses the PicClip control to spin a top.
  341.  
  342. FILES:
  343.    INFOFORM.FRM......The information form.
  344.    INFOFORM.FRX......The binary data for the information form.
  345.    REDTOP.FRM........The main form.
  346.    REDTOP.FRX........The binary data for the main form.
  347.    REDTOP.MAK........The MAKE file for the project.
  348.  
  349. TO RUN:
  350. After starting the Visual Basic environment (VB.EXE), you can 
  351. load files in this sample program by choosing Open Project from
  352. the File menu and select the REDTOP.MAK file.
  353.  
  354. Communications Sample
  355. ---------------------
  356. Program example using MSCOMM.VBX in a terminal emulation program.
  357.  
  358. BRIEF DESCRIPTION:
  359. This sample program illustrates how to use the communications
  360. control with a serial port.
  361.  
  362. BACKGROUND:
  363. MSCOMM.VBX allows you to open a serial port, change its settings, 
  364. send and receive data through the port, and monitor and set many 
  365. of the different data lines.  It's dual-method access allows for 
  366. both polling and event driven communications.
  367.  
  368. FILES:
  369.    CANSEND.FRM.......Dialog box used during file transfer.
  370.    TERMSET.FRM.......Form used to change the serial port settings.
  371.    TERMSET.FRX.......Binary data for TERMSET.FRM.
  372.    VBTERM.FRM........The main form.
  373.    VBTERM.FRX........Binary data for VBTERM.FRM.
  374.    VBTERM.GLO........Global declarations.
  375.    VBTERM.MAK........The MAKE file for the project.
  376.  
  377. TO RUN:
  378. After starting the Visual Basic environment (VB.EXE), you can load
  379. files in this sample program by choosing Open Project from the File
  380. menu and select the VBTERM.MAK file.