home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / w3_prog / 3d.arj / 3D.TXT < prev    next >
Encoding:
Text File  |  1991-08-05  |  4.5 KB  |  119 lines
  1. Welcome to the 3-d world of Windows!
  2.                                                                 
  3. NOTE: This is a new upload of a previous file THREE found in the WINADV forum
  4.       library 1 (New Uploads).
  5.  
  6. To avoid reading this text file, just run the demo.exe program!.
  7.  
  8. Description:
  9. ------------
  10. The file "three_d.dll" contains functions for making a Windows 3.0 dialog box
  11. appear to have a 3-dimensional look.  You can use your own discretion as to
  12. which controls look good with a 3-d appearance.  It requires that you make some
  13. minor changes in your programs's source and build files.  In order for the
  14. DLL to function properly, it must be either in the directory where you are
  15. running your program from or included in a directory which is contained in your
  16. path.  The source code for the demo.exe program is also included.
  17.  
  18. The following are the steps necessary to implement the functions contained in the
  19. DLL:
  20.  
  21. -  Be sure to include the file "three_d.h" in any module which will call a
  22.    function contained in the DLL.  This function contains prototypes for
  23.    each function.
  24.  
  25. -  Modify your link line to contain the library "three_d.lib"
  26.  
  27. -  Modify your dialog box procedure to trap the following messages:
  28.    WM_CTLCOLOR, WM_PAINT and the DLL defined message WM_3DPAINT.
  29.  
  30. -  Modify the dialog box template to exclude the WS_BORDER style from controls
  31.    which will be 3-d.  Note:  For edit controls, this requires subtracting
  32.    2 from cy.
  33.  
  34. Function Descriptions:
  35.  
  36. -  Draw3dFrame(hDlgBox,mode)
  37.  
  38.    hDlgBox     is a handle to the dialog box which you wish to make 3-d.
  39.  
  40.    mode        is an identifier for the type of frame to be drawn.
  41.                INSIDE_FRAME draws a "picture" frame around the box
  42.                OUTSIDE_FRAME draws a "creased" frame around the box.
  43.  
  44.    This function draws a 3_D frame around the client area of the
  45.    specified dialog box.
  46.  
  47. -  Draw3dBorder(hDlgBox,ControlId,mode,depth)
  48.  
  49.    hDlgBox     is a handle to the dialog box which you wish to make 3-d.
  50.  
  51.    ControlId   is the integer identifier for the control you wish to draw.
  52.  
  53.    mode        specifies drawing mode:
  54.                RECESSED makes the control appear "recessed"
  55.                RAISED makes the control appear "raised"
  56.  
  57.    depth       is an integer value defining the width of the pen used for
  58.                drawing.  This governs how "raised" or "recessed" the given
  59.                control will appear.  This value must be 1 or greater.
  60.  
  61.    This function draws a three dimensional border around the specified
  62.    control.
  63.  
  64. -  Draw3dShadow(hDlgBox,ControlId)
  65.  
  66.    hDlgBox     is a handle to the dialog box which you wish to make 3-d.
  67.  
  68.    ControlId   is the integer identifier for the control you wish to draw.
  69.  
  70.    This function draws a "dropped" shadow around the specified control.
  71.  
  72. -  Control3dColor(hDlgBox,wParam)
  73.  
  74.    hDlgBox     is a handle to the dialog box which you wish to make 3-d.
  75.  
  76.    wParam      is the wParam which accompanies the WM_CTLCOLOR message for the
  77.                dialog box.
  78.  
  79.    This function handles the WM_CTLCOLOR message for the specified dialog box.
  80.    It sets the background color for the dialog box to light gray.
  81.  
  82. /*****************************************************************************/
  83.  
  84. Included with this ZIP file, you will find the source code for the demo.exe
  85. program.  Rather than put the sample code in this text file, I thought it would
  86. be easier to include the source.
  87.  
  88. /*****************************************************************************/
  89.                       
  90. If you have any questions or comments I can be reached at the following address
  91. on CompuServe:
  92.  
  93.    76247,1033
  94.  
  95. Your comments would be greatly appreciated!
  96.  
  97. This DLL comes to you without any annoying registration messages.  However,
  98. if you decide to ship the DLL with your own application, I will rely on your
  99. honesty to register the copy.  This will also insure future upgrades.
  100.  
  101. To register your royalty free version of three_d.dll,
  102. Send $20 (for DLL) or $50 (for DLL and source) check or money order to:
  103.  
  104.    Ray Donahue
  105.    365 Mather Street Unit 125
  106.    Hamden, CT 06514
  107.  
  108. Your support would be greatly appreciated!
  109.  
  110. Also Available (for a nominal fee) to registered users:
  111.    -  Source code and DLL for creating "Excel-like" toolbar.
  112.    -  Source code for creating "Excel and Word-like" status bar.
  113.  
  114. To obtain demos for any of the above, leave a message at the CompuServe
  115. address listed above.
  116.  
  117. Once again,
  118. Thanks!
  119.