home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 10 / 10.iso / l / l410 / 4.ddi / README.TXT < prev    next >
Encoding:
Text File  |  1991-05-10  |  11.7 KB  |  330 lines

  1.                   README.TXT
  2.  
  3.         Release Notes for Microsoft (R) Visual Basic (TM)
  4.  
  5.                  Version 1.00
  6.  
  7.           (C) Copyright Microsoft Corporation, 1991
  8.  
  9. This document contains release notes for version 1.00 of Microsoft Visual
  10. Basic for Windows Version 3.0, and later.  Information in this document is
  11. more current than that in the manuals. Information in online Help may also
  12. be more current than that in the manuals.
  13.  
  14. Microsoft revises its languages documentation at the time of reprinting, so
  15. some of the information in this online file may already be included in your
  16. manuals.
  17.  
  18. Contents
  19. ===========================================================================
  20.  
  21. Part    Description
  22. ----    -----------
  23.  
  24. 1    Software Installation Information
  25.  
  26. 2    Notes for "Microsoft Visual Basic Programmer's Guide"
  27.  
  28. 3    Notes for "Microsoft Visual Basic Language Reference"
  29.  
  30. 4    Notes for Tutorial
  31.  
  32. 5    Miscellaneous Notes and Tips
  33.  
  34.  
  35. Part 1: Software Installation Information
  36. ===========================================================================
  37.  
  38. Before installing Visual Basic you should make backup copies of all the
  39. distribution disks.  Do not write-protect the distribution disks you use to
  40. install Visual Basic. If you do, Visual Basic cannot be successfully
  41. installed.
  42.  
  43. Also ensure that the Windows directory, including drive letter, is in your
  44. PATH. If the drive letter is not included in your PATH statement, Visual
  45. Basic will be unable to determine where Windows resides.
  46.  
  47. SETUP.EXE is a Windows application; that is, it is run from Windows, rather
  48. than from the DOS prompt.  SETUP.EXE will only run in Windows Standard or
  49. Enhanced mode. It will not run in Real mode.  You can determine how Windows
  50. is configured on your computer by choosing About from the Help menu in the
  51. Program Manager.
  52.  
  53. To install Visual Basic, use Program Manager or File Manager to start
  54. SETUP.EXE as you would any other Windows application.  For example, if you
  55. are installing from A:
  56.  
  57.     1. From the Program Manager File menu, choose Run.
  58.  
  59.     2. In the Run dialog box, type A:SETUP and choose OK.
  60.  
  61. Most of the files on these disks are compressed and must be expanded before
  62. they can be used. For Visual Basic to work properly, you must install the
  63. files using SETUP.EXE. You cannot simply copy the files to your hard disk.
  64.  
  65.  
  66. Part 2: Notes for "Microsoft Visual Basic Programmer's Guide"
  67. ===========================================================================
  68.  
  69. Page    Section\Note
  70. ----    ------------
  71.  
  72. 117    An Application that Adds and Deletes Menu Commands
  73.     --------------------------------------------------
  74.     Change the last item in the table near the bottom of the page so
  75.     that CtlName is SepBar and Index is blank. At the bottom of the
  76.     table add another line with a blank caption, AppName as the
  77.     CtlName, indented once, with 1 as the Index.
  78.  
  79.     Insert a sentence immediately following the table that reads:
  80.  
  81.     Turn off the Visible property for AppName by toggling the
  82.     Visible check box.
  83.  
  84.     Change "AppName" in the sentence following the table to "SepBar".
  85.  
  86. 118    Delete the sentence that begins "Therefore, you cannot..." from the
  87.     second paragraph on the page. Add the following line of code just
  88.     above the End Sub for the AddApp_Click procedure:
  89.  
  90.     AppName(LMenu).Visible = -1
  91.  
  92. 170    Creating a Control Array
  93.     ------------------------
  94.     In the example code at the bottom of the page Format(I) should be
  95.     Format$(I).
  96.  
  97.  
  98. 223    Displaying the GroupChoice Form
  99.     -------------------------------
  100.     The last sentence on the page should read:
  101.  
  102.     Then create a list box (named GroupList) large enough to hold six
  103.     or more items.
  104.  
  105.  
  106. 353    Chapter 22 - Communicating with Other Applications
  107.     --------------------------------------------------
  108.     This chapter discusses the links that enable applications to
  109.     exchange information through dynamic-data exchange (DDE). The
  110.     correct names for the two kinds of DDE links are "hot link" and
  111.     "cold link." On pages 360, 370, and 371 cold links are incorrectly
  112.     referred to as "warm."
  113.  
  114.  
  115. 360    LinkTimeOut
  116.     -----------
  117.     The note near the bottom of the page incorrectly indicates that the
  118.     Alt key is pressed to interrupt pending DDE operations. Actually,
  119.     the Esc key is used to interrupt DDE operations.
  120.  
  121.  
  122. 364    LinkExecute
  123.     -----------
  124.     The example code shown will work correctly, however to be
  125.     syntactically correct, it should appear as follows:
  126.  
  127.     Sub Form_LinkExecute (CmdStr As String, Cancel As Integer)
  128.         Const FALSE = 0, TRUE = Not FALSE
  129.         If CmdStr = "[Quit]" Then
  130.         Cancel = FALSE
  131.         End
  132.         Else
  133.         Cancel = TRUE
  134.         End If
  135.     End Sub
  136.  
  137.  
  138. 386    Null Pointers
  139.     -------------
  140.     The call to the FindWindow DLL routine near the top of the page
  141.     should read as:
  142.  
  143.     hWndExcel% = FindWindow%(ByVal 0&, ByVal "Microsoft Excel")
  144.  
  145.     Insert the following paragraph immediately following the statement
  146.     shown above:
  147.  
  148.     The use of ByVal when passing a string is necessary because the
  149.     data type of that argument was declared as Any. Including ByVal
  150.     when passing a string declared as Any causes Visual Basic to
  151.     convert the string to the null-terminated form expected by most
  152.     DLL routines.
  153.  
  154.  
  155. 386    Properties
  156.     ----------
  157.     The Lib clause in the external function Declare statement should
  158.     say "GDI" instead of "User."
  159.  
  160.  
  161. Part 3: Notes for "Microsoft Visual Basic Language Reference"
  162. ===========================================================================
  163.  
  164. Page    Section\Note
  165. ----    ------------
  166.  
  167.   9    Table 3 - Properties by Programming Task
  168.     ----------------------------------------
  169.     In the Windows category at the bottom of the page, the property for
  170.     "Get handle for form" should be hWnd, not hWin.
  171.  
  172.  
  173.  27    AutoRedraw Property
  174.     -------------------
  175.     The Note should include the following paragraph:
  176.  
  177.     When you minimize a form whose AutoRedraw property is set to False
  178.     (0), ScaleHeight and ScaleWidth are set to icon size. When
  179.     AutoRedraw is set to True (-1), ScaleHeight and ScaleWidth remain
  180.     the size of the restored window.
  181.  
  182.  
  183.  31    BorderStyle Property
  184.     --------------------
  185.     In the Description section change the word "picture" to "text."
  186.  
  187.     Add the following paragraph at the end of the Remarks section:
  188.  
  189.     Because of appearance, the BorderStyle for forms with a menu can
  190.     only be set to Sizable (2) or Fixed Single (1). Setting the
  191.     BorderStyle property to None (0) or Fixed Double (3) forces the
  192.     BorderStyle property to Fixed Single (1).
  193.  
  194.  
  195. 147    Icon Property
  196.     -------------
  197.     In the Description section change "read-only" to "read-write."
  198.  
  199.     Change the note to read as follows:
  200.  
  201.     For a form icon to be functional, the BorderStyle property must be
  202.     set to either 1 (Fixed Single) or 2 (Sizable). The MinButton
  203.     property must be set to True (-1).
  204.  
  205.     At run time, you can assign an object's Icon property to another
  206.     object's DragIcon or Icon property. You can also assign an icon
  207.     returned by the LoadPicture function. Doing this assigns an empty
  208.     (null) icon, which enables you to draw on the icon at run time.
  209.  
  210.  
  211. 176    LinkExecute Event
  212.     -----------------
  213.     The default value for the Cancel% argument to the LinkExecute event
  214.     is True (-1). This is done so that if no LinkExecute procedure is
  215.     written, Visual Basic properly returns a negative acknowledgement
  216.     to any application that attempts to send a string to Visual Basic
  217.     to be executed.
  218.  
  219.  
  220. 188    List Property
  221.     -------------
  222.     The last sentence in the Description should be changed to read:
  223.  
  224.     The List property is not available at design time; it is read-only
  225.     for drive, file, and directory list boxes and read-write for combo
  226.     and list boxes.
  227.  
  228.  
  229. 285    SetData Method
  230.     --------------
  231.     The parentheses shown in the syntax example should be removed.
  232.  
  233.  
  234. Part 4: Notes for Tutorial
  235. ===========================================================================
  236.  
  237. Tutorial Screen Conflicts
  238. -------------------------
  239. Some Windows programs that run in the background and automatically perform
  240. some action on the screen may behave unpredictably when the Visual Basic
  241. Tutorial is running. For this reason, we recommend that you turn off or
  242. unload screen savers and background clock-type programs before running the
  243. Tutorial.
  244.  
  245.  
  246. Part 5: Miscellaneous Notes and Tips
  247. ===========================================================================
  248.  
  249. Using Frames
  250. ------------
  251. If you plan to group controls on a form using a frame, draw your frame
  252. first, then draw the controls in the frame. This allows you to reposition
  253. the frame and the controls it contains as a single unit rather than having
  254. to move each part separately.
  255.  
  256.  
  257. Deleting or Renaming Controls
  258. -----------------------------
  259. When you delete or rename a control for which you have written event
  260. procedures, the event procedures themselves are not deleted. All such event
  261. procedures become general procedures with their names preserved. If you
  262. create a new control of the same name, those general procedures will once
  263. again become attached to that control. If you rename those general
  264. procedures to match the name of an existing control, they too will become
  265. attached to that control. Note that while the event procedures are
  266. restored, the value of any properties you previously assigned to the
  267. deleted control are lost.
  268.  
  269.  
  270. Displaying Modal Forms from the Immediate Window
  271. ------------------------------------------------
  272. Forms cannot be displayed modally using the Show method in the Immediate
  273. window. You can, however, call a procedure from the Immediate window which
  274. contains a Show method to display a modal form. There are no restrictions
  275. on the display of non-modal forms.
  276.  
  277.  
  278. Design-Time Dynamic Data Exchange (DDE)
  279. ---------------------------------------
  280. If you establish a design-time DDE link (either as a client or as a server)
  281. between another application and a Visual Basic text box, changing any
  282. property which causes the text box to be destroyed and recreated will
  283. terminate the link.  For example, changing a text box from single line to
  284. multiline terminates a design-time DDE link; the Visual Basic developer
  285. must re-establish the link if it's still needed.
  286.  
  287.  
  288. Terminating DDE Links During Form_Unload
  289. ----------------------------------------
  290. You must terminate all DDE links before you close a form that contains
  291. any controls involved in the link.
  292.  
  293.  
  294. Submenu Visibility
  295. ------------------
  296. If you have a menu with submenu items, at least one submenu item must
  297. always be visible, i.e., the Visible property must be set to True (-1).
  298.  
  299.  
  300. Calling DLL Routines by Ordinal Number
  301. --------------------------------------
  302.  
  303. Some DLLs export their routines by ordinal number rather than by name. To
  304. call one of these DLL routines, you must declare it with an alias string
  305. that includes the number sign character (#) followed by the ordinal number.
  306. For example, to declare the routine with ordinal number 234:
  307.  
  308.     Declare Sub AnyRoutine Lib "AnyDLL" Alias "#234" (ByVal Var As Long)
  309.  
  310.  
  311. Default WindowState
  312. -------------------
  313. Whatever WindowState (minimized, restored, or maximized) a form is when
  314. Visual Basic goes to Run mode may become the new default WindowState. If
  315. you want your forms to retain a specific WindowState you must either close
  316. the form before running or explicitly set the WindowState in the Form_Load
  317. event. However, this last technique prevents the application from being run
  318. in a state different from the state explicitly set.
  319.  
  320.  
  321. Custom Controls
  322. ---------------
  323. You must remove all instances of a custom control from project forms before
  324. removing the custom control file from the project.
  325.  
  326. If you're replacing or updating a custom control file with a newer version,
  327. you should not remove (using File Remove File) the old version and then add
  328. the new version (using File Add File). Instead, simply copy the new version
  329. over the old version and reload the entire project.
  330.