home *** CD-ROM | disk | FTP | other *** search
/ CICA 1993 August / CICA.cdr / unzipped / programr / bcpp / clikbr15 / addenda.doc next >
Encoding:
Text File  |  1993-03-23  |  9.2 KB  |  268 lines
  1.                              Addenda.Doc
  2.  
  3. This file is the v1.5 addendum to the manual for ClickBar v1.0, and contains
  4. information pertinent to the v1.5 maintenance release of ClickBar.
  5.  
  6. All manual references in this document are referring to the ClickBar.DOC
  7. manual dated 18-Apr-92. This document is a supplement to that manual, a new
  8. manual to be issued with the v2.0 upgrade.
  9.  
  10.  
  11. Installation
  12. ────────────
  13.  
  14. Installation of ClickBar v1.5 is accomplished by means of a Setup.EXE
  15. provided on the release diskette. All files from v1.0 may be deleted prior to
  16. the v1.5 installation, if desired. Any needed files are on the v1.5
  17. diskettes, and any files not needed are not loaded. Therefore, a cleaner
  18. install would be to remove the WynApse subdirectory, start Windows, and run
  19. Setup.exe.
  20.  
  21.  
  22. WynBtn
  23. ──────
  24.  
  25. WynBtn.DLL is no longer supported by WynApse, and is not used in ClickBar,
  26. therefore not necessary to the use of ClickBar.DLL or ClickDlg.DLL. It is
  27. still used during Setup at this time, but then may be removed from the users
  28. hard disk. WynBtn.h may also be removed.
  29.  
  30.  
  31. BWCC.DLL
  32. ────────
  33.  
  34. In the same manner, ClickDlg no longer relies upon BWCC.DLL. Borland users
  35. may still desire to use it for the 3D effects on the dialog boxes, but it is
  36. not necessary for the proper execution of ClickBar. As you will see below,
  37. BWCC.DLL is no longer loaded in TestClik.C, and TestClik.exe is virtually
  38. identical to the v1.0 version. 
  39.  
  40. As with WynBtn, BWCC is used during Setup, but is not required for the
  41. operation of ClickBar.DLL or ClickDlg.DLL.
  42.  
  43. The removal of the need for the two DLLs results in less memory being used
  44. during the execution of the utilities.
  45.  
  46.  
  47. End-User Registration
  48. ─────────────────────
  49.  
  50. End-User Registration for v1.0 fails under Windows 3.1. This v1.5 maintenance
  51. upgrade of ClickBar and ClickDlg addresses this problem. The developer
  52. instructions for run-time registration on Page 7 of the manual are still
  53. correct. 
  54.  
  55. The only change necessary is to page 14 of the manual. It is not necessary to
  56. deliver a WynApse.INI file to an end-user. This is taken care of in
  57. ClickBar.DLL, while processing your registration name and number. The bottom
  58. half of page 14, starting with the sentence:
  59.  
  60. "The only acceptable time to build ..."
  61.  
  62. is to be ignored.
  63.  
  64.  
  65. Single-Image Bitmaps
  66. ────────────────────
  67.  
  68. The upgrade to single-image bitmaps intended for v2.0 has been pulled down to
  69. this maintenance release. This brings the user a smaller DLL, and
  70. easier-to-use custom button interface. Instead of having to produce two
  71. images for a custom button, the developer only needs to produce a single,
  72. flat image, and ClickBar v1.5 will 3D it in an up- and down-image format. Of
  73. course, if there is a need for two images, that is still possible. ClickBar
  74. will still provide the proper 3D effect, but will handle both images
  75. provided. This is demonstrated in ClikTest.EXE with the VCR buttons, and one
  76. of the large buttons on the "Pick" button palette in TestClik has a double
  77. image.
  78.  
  79. Custom bitmaps are still bound-in to the users EXE as with v1.0, according to
  80. the manual. If a double image is desired, the even/odd 1000/3000 naming
  81. concept is still valid on page 11 of the manual. If a single image is
  82. sufficient, ignore the need for the odd numbered '3000' button. If only one
  83. is found, only one is used. If two are found, two are used. That's how simple
  84. it is. Examples of using both types of buttons are found in TestClik.RC.
  85.  
  86.  
  87. Button Profiles
  88. ───────────────
  89.  
  90. The only drawback to changing to single-image buttons is forcing users to
  91. redraw current custom images. Remember each button only requires one image
  92. now, so the job is cut in half. And, new buttons are not being produced, only
  93. extracted from current ones. 
  94.  
  95.  
  96.    ───────────────
  97.    22x18 16 colors
  98.  
  99. This button profile requires a 17x13 flat image that will sit inside the 3D
  100. borders. Cutting the 17x13 center from an existing button will suffice for
  101. most custom images.
  102.  
  103.  
  104.    ───────────────
  105.    25x22 16 colors
  106.  
  107. This button profile requires a 20x17 flat image that will sit inside the 3D
  108. borders. Cutting the 20x17 center from an existing button will suffice for
  109. most custom images.
  110.  
  111.  
  112.    ───────────────
  113.    24x24 16 colors
  114.  
  115. This button profile requires a 19x19 flat image that will sit inside the 3D
  116. borders. Cutting the 19x19 center from an existing button will suffice for
  117. most custom images.
  118.  
  119.  
  120. TestClik Changes
  121. ────────────────
  122.  
  123. The following detail changes made to TestClik code for v1.5. Some of the
  124. changes are Windows 3.1, some are ClickBar v1.5.
  125.  
  126.  
  127.    ────────────
  128.    TestClik.mak
  129.  
  130. bwcc.lib was added to TestClik.mak. For non-Borland programmers, remove this
  131. line, and any other Borland references. Additionally, the make file was
  132. modified to handle Windows 3.0/3.1 changes. Compiling with the Windows 3.1 
  133. compatible compilers (Microsoft and Borland, both) necessitate a few
  134. additions to run under Windows 3.0. Specifically, 
  135.  
  136.   RC testclik.res testclik.exe
  137.  
  138. is changed to:
  139.  
  140.   RC -30 testclik.res testclik.exe
  141.  
  142. and the help compiler should still compile using the 3.0-compatible compiler
  143. because 3.1 help files are not compatible with Windows 3.0.
  144.  
  145.  
  146.    ────────────
  147.    TestClik.Def
  148.  
  149. The only change to TestClik.Def was to the exports list. Instead of exporting
  150. the dialog procedure 'TestClikDlgProc', now 'PickDlgProc' is exported. This
  151. is a demo of a floating custom button palette.
  152.  
  153.  
  154.    ──────────
  155.    TestClik.H
  156.  
  157. A few IDs have been removed from TestClik.H. These had to do with the setup
  158. dialog box that was replaced by a button palette.
  159.  
  160.  
  161.    ────────────
  162.    TestClik.Dlg
  163.  
  164. The "testclik" dialog box profile is removed in this version of TestClik. In
  165. its place "Pick", a floating custom button palette is inserted. This is seen
  166. as a grid of 8 custom profile #2 buttons. The "CLICK" profile is changed only
  167. in that the Borland "BorShade" control is no longer used for the button
  168. background. This colorization is now taken care of in ClickDlg.DLL.
  169.  
  170.  
  171.    ───────────
  172.    TestClik.RC
  173.  
  174. TestClik.RC has been modified to remove references to double-button images
  175. except where desired. Also, the bitmap images for the button palette have
  176. been added.
  177.  
  178.  
  179.    ──────────
  180.    TestClik.C
  181.  
  182. TestClik.C has the majority of changes necessary. To compile with Windows 3.1
  183. tools and run under Windows 3.0 requires the addition of:
  184.  
  185. #define WINVER 0x0300
  186.  
  187. prior to including windows.h
  188.  
  189. The other required change in this respect is the casting of:
  190.  
  191. WndClass.lpfnWndProc   = WndProc;
  192.  
  193. to become:
  194.  
  195. WndClass.lpfnWndProc   = (WNDPROC)WndProc;
  196.  
  197. this is found in the function WinMain, but is mentioned here for
  198. completeness.
  199.  
  200. As explained above, references to WynBtn, or WynBtn.DLL are unnecessary in
  201. v1.5 code.
  202.  
  203. 'TestClikDlgProc' is no longer in TestClik, so any reference to it, and its
  204. prototype will be missing.
  205.  
  206. The additional button palette 'PickDlgProc' has been added along with a
  207. prototype for it.
  208.  
  209. The HWND declaration:
  210.  
  211. HANDLE  hClickBar, hClickDlg;
  212.  
  213. has been moved to be global for proper execution of TestClik.exe, as has been
  214. the declaration of
  215.  
  216. FARPROC lpfnDlgSetup;
  217.  
  218. This was pulled out global as will be shown later.
  219.  
  220. A major change was the removal of:
  221.  
  222. (*lpfnDlgSetup)(hWndMain);
  223.  
  224. from WinMain to the init section of WndProc. This was moved to prevent a 
  225. race condition with ClickDlg.DLL trying to operate on NULL window handles.
  226. Users that have found DBWIN to display error messages with the debug version
  227. of Microsoft Windows SDK will now find them to be clean with this change.
  228.  
  229. The message dispatch loop of WinMain was modified to accommodate the control
  230. palette by changing the if statement from:
  231.  
  232.    if (hWndDlg == 0 || !IsDialogMessage(hWndDlg, &msg))
  233.  
  234. to be:
  235.  
  236.    if ((hWndDlg == 0 || !IsDialogMessage(hWndDlg, &msg)) && 
  237.                   (hDlgModeLess == 0 || !IsDialogMessage(hDlgModeLess, &msg)))
  238.  
  239. As explained above, WM_NCCREATE is now captured in WndProc to properly make
  240. the DlgSetup call. If this is captured, the DefWindowsProc should be executed
  241. to allocate memory for the procedure, and error appropriately.
  242.  
  243. The button palette is displayed as a modeless dialog box, and the
  244. instantiation of that box is defined in WndProc.
  245.  
  246. This brings up the last modification, that being the addition of the button
  247. palette procedure handler 'PickDlgProc'. This is very similar to the main
  248. message loop in WndProc that handles the button presses from the main
  249. toolbar.
  250.  
  251.  
  252. Additional Files
  253. ────────────────
  254.  
  255. Included on the release diskette is TOOLBAR.ZIP and CLICKIN.ZIP. TOOLBAR.ZIP
  256. is the 'Toolin' toolbar from Windows/DOS Developer's Journal, and
  257. demonstrates a toolbar compiler. The demo runs as a menu-driven application.
  258. The second file, CLICKIN.ZIP is a subclass of Toolin.EXE that will place a
  259. custom toolbar into a pre-compiled 3rd-party application. The code and
  260. concept used in Clickin may be used without any reservation for any purpose
  261. to be found useful. The code is released to the public domain "as-is". Any
  262. enhancements by email or otherwise would be appreciated.
  263.  
  264. Starting with version 1.5 of ClickBar, PKZIP v2.04C is being used. Since this
  265. is relatively new, I am including the shareware version of this tool on my
  266. diskette.  Please support PKWare in their efforts, as you have WynApse.
  267.  
  268.