home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / MAJ / 1513 / WINEDIT.BO_ < prev    next >
Text File  |  1993-10-07  |  65KB  |  2,071 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                              WinEdit User's Manual
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                                     Wilson WindowWare, Inc.
  21.                                                2701 California Ave SW  #212
  22.                                                    Seattle,  WA  98116  USA
  23.  
  24.                                                    Orders:   (800) 762-8383
  25.                                                    Support:  (206) 937-9335
  26.                                                    Fax:      (206) 935-7129
  27.  
  28.                       Copyright c 1990-1993 by Steve Schauer
  29.                               All Rights Reserved
  30.  
  31.      No part of this manual may be reproduced or transmitted in any form or
  32.      by any means, electronic or mechanical, including photocopying and
  33.      recording, for any purpose without the express written permission of
  34.      Wilson WindowWare, Inc.  Information in this document is subject to
  35.      change without notice and does not represent a commitment by Wilson
  36.      WindowWare, Inc.
  37.  
  38.      The software described herein is furnished under a license agreement.
  39.      It is against the law to copy this software under any circumstances
  40.      except as provided by the license agreement.
  41.  
  42.      U.S. GOVERNMENT RESTRICTED RIGHTS
  43.      Use, duplication, or disclosure by the Government is subject  to
  44.      restrictions as set forth in subdivision (b)(3)(ii) of the Rights in
  45.      Technical Data and Computer Software clause at 252.227-7013.
  46.      Contractor/manufacturer is Wilson WindowWare /2701 California Ave SW
  47.      /suite 212/ Seattle, WA 98116
  48.  
  49.      TRADEMARKS
  50.      Microsoft and MS-DOS are registered trademarks of Microsoft
  51.      Corporation.
  52.      Windows is a trademark of Microsoft Corporation.
  53.      WinEdit is a trademark of Wilson WindowWare, Inc.
  54.  
  55.  
  56.  
  57.  
  58.                                     CONTENTS
  59.  
  60.      WinEdit OverView.......................1
  61.  
  62.      WinEdit Keyboard and Mouse Commands....2
  63.           Moving the Insertion Point........2
  64.           Selecting Text....................2
  65.           Help Keys.........................2
  66.           Other Keys........................3
  67.           Mouse Operations..................3
  68.  
  69.      Running Multiple Instances of WinEdit..4
  70.  
  71.      WinEdit Menus..........................5
  72.           File Menu Commands................5
  73.           Edit Menu Commands................7
  74.           Search Menu Commands..............8
  75.           Project Menu Commands............10
  76.           Macro Menu Commands..............10
  77.           Window Menu Commands.............11
  78.           Utility Menu Commands............11
  79.  
  80.      WinEdit Procedures....................12
  81.           Printer Options..................12
  82.           Compiling........................12
  83.           Control Bar......................13
  84.  
  85.      Editing Text..........................15
  86.           Editing Shortcuts:...............15
  87.           Deleting Text....................15
  88.           Tab and SHIFT Tab................15
  89.  
  90.      Working With Multiple Documents.......17
  91.  
  92.      Extended Help.........................18
  93.  
  94.      Finding Text..........................19
  95.  
  96.      Using Regular Expressions.............20
  97.  
  98.      Windows 3.1 Support...................21
  99.           "Drag and Drop"..................21
  100.           "Sounds".........................21
  101.  
  102.      Printing Documents....................22
  103.  
  104.      Saving Documents......................23
  105.  
  106.      Setting Preferences...................24
  107.  
  108.      Setting Margins, Headers and Footers..25
  109.           Headers and Footers..............25
  110.           Margins..........................25
  111.  
  112.      Undo and Redo.........................26
  113.           Undo.............................26
  114.           Redo.............................26
  115.  
  116.      WinEdit Project Files.................27
  117.  
  118.      WinEdit Extensions....................28
  119.           Creating a WinEdit Extension.....28
  120.           Loading the Extension............28
  121.           Processing Menu Selections.......29
  122.           Initializing the Extension Menu..30
  123.           WinEdit Extension Example........31
  124.  
  125.      Configuring the Utility Menu..........35
  126.  
  127.  
  128.  
  129.  
  130.      WinEdit OverView
  131.  
  132.      WinEdit is an ASCII text editor capable of editing numerous ASCII text
  133.      files of an almost unlimited size (limited only by available Windows
  134.      memory).  WinEdit is first and foremost a programmer's editor, with
  135.      many features designed for creating and maintaining program source
  136.      code.  Build, debug and run your programs directly from WinEdit with
  137.      the ability to view any compiler errors or warnings and the
  138.      corresponding source code.
  139.  
  140.      As an ASCII text editor, WinEdit allows you to open numerous text
  141.      files at once, print half sized "two-up" pages side by side in
  142.      landscape orientation, print headers and footer text (document name,
  143.      date and time, page number), merge files together, and word wrap your
  144.      text to the size of the window (word wrap).
  145.  
  146.      WinEdit has the following file limits:
  147.  
  148.           Maximum of 65,535 lines
  149.           Lines must end with carriage return/line feed combination
  150.           Maximum line length of 1,024 characters
  151.           File cannot contain NULL characters
  152.  
  153.      Some features in this documentation include the designation [Standard]
  154.      or [Professional].  This indicates a feature which is not available in
  155.      the Lite version of WinEdit.  The Standard version of WinEdit includes
  156.      all features described here except those designated [Professional].
  157.      The Professional version includes all features described here.
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.      1
  181.  
  182.      WinEdit Keyboard and Mouse Commands
  183.  
  184.      Moving the Insertion Point
  185.  
  186.      Key(s)              Function
  187.      ------------        --------------------------
  188.      Up Arrow            Moves up one line.
  189.      Down Arrow          Moves down one line.
  190.      Right Arrow         Moves right one character.
  191.      Left Arrow          Moves left one character.
  192.      CTRL+Right Arrow    Moves right one word (insertion point is
  193.                          positioned at the beginning of the next word).
  194.      CTRL+Left Arrow     Moves left one word (insertion point is positioned
  195.                          at the beginning of the previous word).
  196.      Home                Moves to the beginning of the line.
  197.      End                 Moves to the end of the line.
  198.      PgUp                Moves the view up one screenful.
  199.      PgDn                Moves the view down one screenful.
  200.      CTRL+Home           Moves to the beginning of the document.
  201.      CTRL+End            Moves to the end of the document.
  202.  
  203.      Selecting Text
  204.  
  205.      Key(s)              Function
  206.      ------------        --------------------------
  207.      SHIFT+Arrow         Extends the selection of text one character at a
  208.                          time.
  209.      SHIFT+Down or Up    Selects one line of text up or down from the
  210.                          current selection.
  211.      SHIFT+Home          Selects text from the insertion point to the
  212.                          beginning of the line.
  213.      SHIFT+End           Selects text from the insertion point to the end
  214.                          of the line.
  215.      CTRL+SHIFT+Arrow    Selects the previous word.
  216.      CTRL+SHIFT+Arrow    Selects the next word.
  217.      SHIFT+PgUp          Selects the previous screen of text.
  218.      SHIFT+PgDn          Selects the next screen of text.
  219.      CTRL+SHIFT+Home     Selects text from the insertion point to the
  220.                          beginning of the document.
  221.      CTRL+SHIFT+End      Selects text from the insertion point to the end
  222.                          of the document.
  223.  
  224.      Help Keys
  225.  
  226.      Key(s)              Function
  227.      ------------        --------------------------
  228.      F1                  WinEdit Help Index
  229.      Shift+F1*           Extended Help (Keyword Help)
  230.  
  231.      *The cursor needs to be positioned on the keyword function, message or
  232.      data structure name when pressing SHIFT+F1.
  233.  
  234.  
  235.  
  236.      2
  237.  
  238.      Other Keys
  239.  
  240.      Press the Tab key to insert a number of spaces and bring the insertion
  241.      point to the next tab stop.  The number of spaces inserted when the
  242.      tab key is pressed is configurable in File Preferences (choose any
  243.      value from 1 to 12).  For example if the "Tab Size" is set to 3 in
  244.      File Preferences, pressing the Tab key will advance the cursor three
  245.      spaces to the right.
  246.  
  247.      The SHIFT+Tab key combination moves the current position back to the
  248.      previous tab stop (to the left).  For example if the "Tab Size" is set
  249.      to 3 in File Preferences, pressing the SHIFT+Tab key combination will
  250.      move the cursor three spaces/positions to the left.
  251.  
  252.      If there is any text selected, the Tab and SHIFT+Tab keys will shift
  253.      every line in the selection forwards (Tab) or backwards (SHIFT+Tab) by
  254.      one tab stop.
  255.  
  256.      Mouse Operations
  257.  
  258.      Click the Left mouse button on Control Bar along the top of the
  259.      WinEdit screen and drag your mouse to "tear" the Control Bar from the
  260.      top of the window.  The Control Bar can be resized or moved anywhere
  261.      on the screen.  See Control Bar for more information.
  262.  
  263.      Click the Right mouse button anywhere on the document window and a
  264.      Popup menu will appear with a number of commands (such as Cut, Copy,
  265.      Paste, and Keyword Help).
  266.  
  267.      Hold the SHIFT key and click the Right mouse button on any Windows SDK
  268.      function, message, or data structure name and WinEdit will access the
  269.      SDKWIN.HLP topic for that item.
  270.  
  271.      Double click the Left mouse button over a word to select the word.
  272.  
  273.      Double click the Left mouse on message area of the status bar (the
  274.      area to the right of the INS/OVR indicator) to jump to the Next Error
  275.      message.
  276.  
  277.      Double click the Left mouse button on word "Line" in the status bar to
  278.      bring up the Goto to Line box.
  279.  
  280.      Double click the Left mouse button on "INS" or "OVR" in the status bar
  281.      to toggle between insert and overtype mode.
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.      3
  293.  
  294.  
  295.  
  296.  
  297.      Running Multiple Instances of WinEdit
  298.  
  299.      When starting a new copy of WinEdit, the active copy will be
  300.      reactivated.  If an associated file is double clicked, the current
  301.      copy will load that file.  WinEdit will only allow a single instance,
  302.      unless the following entry is added to the WINEDIT.INI file:
  303.  
  304.           MULTIPLEINST=1
  305.  
  306.      The WINEDIT.INI file is a text file located in your Windows directory.
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.      4
  349.  
  350.      WinEdit Menus
  351.  
  352.      File Menu Commands
  353.  
  354.      New
  355.      Opens a new untitled document window.  Existing documents will not be
  356.      closed when opening a new document.
  357.  
  358.      Open...
  359.      Opens a new window with the contents of an existing document/file.
  360.      List the files of a certain type by selecting one of the following
  361.      from the lower list box of file types:
  362.  
  363.        Source Files (*.c;*.h;*.rc;*.def)
  364.        Text Files (*.txt)
  365.        All Files (*.*)
  366.  
  367.      WinEdit can open an ASCII text file as large as available Windows
  368.      memory.  Select the appropriate drive and directory, select a file to
  369.      open and choose the OK button.  The default directory for the File
  370.      Open command is set in the Project Management dialog (choose Configure
  371.      from the Project menu).  Once a file is opened, the full path and
  372.      filename is displayed in the caption bar of the window.
  373.  
  374.      Merge...
  375.      To merge in the contents of another file into the active
  376.      windows/document, position your cursor at the location where you would
  377.      like the text from another file to appear.  Choose Merge from the File
  378.      menu, select a filename and choose the OK button to merge in the text.
  379.      WinEdit will merge the contents of the file you selected starting on
  380.      the line just below your insertion point.
  381.  
  382.      Previous Files...
  383.      Choose Previous Files to quickly open a file that you previously
  384.      edited.  WinEdit remembers the last 20 files that you have had open
  385.      and lists these files in the Reopen File dialog.  Double click on a
  386.      filename in the list box or select the file and choose the OK button
  387.      to open the file.  If the you wish to open is not listed, choose the
  388.      Open Now button to access the standard File Open dialog.
  389.  
  390.      Close
  391.      To close the document window before you, select Close from the File
  392.      menu or double click on the close bar for the active window.  If the
  393.      document has changed since you last saved the file, WinEdit will
  394.      prompt you to save changes to the file.
  395.  
  396.      Save
  397.      Saves the contents of the current window to disk.  If the document is
  398.      UNTITLED, WinEdit prompts you for a document name.  In the Save File
  399.      As dialog, provide a File Name with an extension (WinEdit does not
  400.      automatically add a file extension to your filename).  The file
  401.      remains open after it is saved to disk.
  402.  
  403.  
  404.      5
  405.  
  406.  
  407.  
  408.  
  409.      Save As...
  410.      Choose the Save As option to save the contents of the active window to
  411.      a new or different filename.  With the Save As command you can save
  412.      FILE1.TXT as FILE2.TXT, leaving FILE1.TXT on disk as previously saved
  413.      with the latest changes written to FILE2.TXT.
  414.  
  415.      Print
  416.      Prints the current document using the print settings entered in the
  417.      Page Setup dialog box.
  418.  
  419.      Page Setup...
  420.      Allows you to set the margins, header and/or footer text, select a
  421.      printer font, and choose a page layout (one portrait page of text per
  422.      page or two pages in a landscape orientation).
  423.  
  424.      Printer Setup...
  425.      Before printing from WinEdit, choose Printer Setup to access printer
  426.      options for the active Windows printer driver.
  427.  
  428.      Preferences...
  429.      Allows you to choose the screen font WinEdit uses for displaying text
  430.      in the document window, the tab size (number of spaces per tab),
  431.      whether the Control Bar is shown, and startup window size and an
  432.      optional message box sound.
  433.  
  434.      Key Assignments...
  435.      Allows you to redefine the shortcut keys used in WinEdit.
  436.  
  437.      Exit
  438.      Closes all open windows and exits the WinEdit program.  If there are
  439.      any unsaved files, WinEdit prompts you to save each file before
  440.      exiting.  If you intend to close all of the open windows/documents and
  441.      not exit WinEdit, then choose Close All from the Window menu.
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.      6
  460.  
  461.      Edit Menu Commands
  462.  
  463.      Undo
  464.      Allows you to "undo" previous editing actions.  WinEdit can undo the
  465.      following edits:
  466.  
  467.           Inserting a character.
  468.           Deleting a character.
  469.           Cutting a selection.
  470.           Pasting a selection.
  471.  
  472.      WinEdit can undo the last 2000 editing actions.  Press CTRL+Z to undo
  473.      the last editing action.
  474.  
  475.      Redo
  476.      Allows you to reverse any Undo command.  If you undo an editing action
  477.      by mistake, you can "redo" the edit.  Press SHIFT+CTRL+Z to redo the
  478.      last editing action.
  479.  
  480.      Cut
  481.      Removes the current selection (highlighted text) from the document and
  482.      places it on the Windows clipboard.  You can then paste the contents
  483.      of the clipboard at another position in the document, into a new
  484.      document, or into another Windows application.
  485.  
  486.      Copy
  487.      Places a copy of the current selection (highlighted text) on the
  488.      Windows clipboard without removing it from the document.  You can then
  489.      paste the contents of the clipboard at another position in the
  490.      document, into a new document, or into another Windows application.
  491.  
  492.      Paste
  493.      Inserts the text from the Windows clipboard into the document at the
  494.      current insertion point.
  495.  
  496.      Delete
  497.      Removes the current selection from the document without changing the
  498.      contents of the clipboard.  If there is no selection, the character to
  499.      the right of the insertion point is deleted.
  500.  
  501.      Insert Mode
  502.      When Insert Mode is selected from the Edit menu, text is inserted at
  503.      the current insertion position (if there is text to the right of the
  504.      insertion position the text is pushed to the right as you insert
  505.      text).  When Insert Mode is not selected, WinEdit is in "Overtype"
  506.      mode.  When in Overtype mode, text to the right of the insertion
  507.      position is overwritten with the new text that is typed.  The status
  508.      line at the bottom of the WinEdit screen, indicates the current
  509.      editing status:
  510.  
  511.        OVR - Overtype is active
  512.        INS - Insert mode is active
  513.  
  514.  
  515.      7
  516.  
  517.  
  518.  
  519.  
  520.      The Insert or INS key toggles the editing mode from OVR to INS and
  521.      back.
  522.  
  523.      Word Wrap
  524.      When Word Wrap is selected from the Edit menu, any text you enter will
  525.      automatically wrap to the next line when the end of the line is
  526.      reached (the end of the line is determined by the width of the
  527.      document window).  Turning Word Wrap "on" does not affect the word
  528.      wrap of existing text, but rather only new text that is typed into the
  529.      window.
  530.  
  531.      Column Block  (ALT+C)
  532.      To select a column of text, turn the Column Break option on (press
  533.      ALT+C) prior to selecting text.  You can then select text using the
  534.      mouse or by holding down the Shift key and using the arrow keys on the
  535.      keyboard to extend the selection.  Column select allows you to select
  536.      a portion of a line for multiple lines, i.e.  columns 5-10 for lines
  537.      100-120.  The status bar at the bottom of the WinEdit window displays
  538.      the column and line number for the cursor position (i.e. Line 6 Col
  539.      16).
  540.  
  541.      Select All
  542.      Selects all of the text in the document window.
  543.  
  544.      Search Menu Commands
  545.  
  546.      Find...
  547.      Searches for text in a document.
  548.  
  549.      You can specify these options:
  550.      * Find              Type the text you want to find.
  551.      * Match Upper/
  552.        Lower Case        Select this box to match the upper and lower case
  553.                          exactly.
  554.      * Regular
  555.        Expressions       Select this box to use regular expressions.
  556.      * Forward           Search forward in the document starting at the
  557.                          insertion point.
  558.      * Backward          Search backward in the document starting at the
  559.                          insertion point.
  560.  
  561.      Repeat Last Find
  562.      Allows you to repeat the last search using the same options as the
  563.      previous search, without opening the Find dialog box again.  The quick
  564.      key combination to repeat the last search/find is CTRL+F5.
  565.  
  566.  
  567.  
  568.  
  569.  
  570.      8
  571.  
  572.      Change...
  573.      Searches for text within a document and replaces the found text with
  574.      text you specify (essentially a search and replace function).
  575.  
  576.      You can specify the following options:
  577.  
  578.      * Find              Type the text you want to find in the document.
  579.      * Replace with      Type the text you want to insert in place of the
  580.                          found text.
  581.      * Match case        Select this box to match the upper and lower case
  582.                          exactly.
  583.      * Regular
  584.        Expressions       Select this box to use regular expressions.
  585.      * Search backwards  Search backward through the document starting at
  586.                          the insertion point.
  587.      * Confirm before
  588.        changing          When the search text is found, you will be asked
  589.                          if you want to change the occurrence with the
  590.                          replacement text (choose Yes, No or Cancel).
  591.      * Change All        When this option is selected, WinEdit will start
  592.                          at the current cursor position and search the
  593.                          entire document.  If the "Confirm before changing"
  594.                          box is selected, you will be asked if you want to
  595.                          change the occurrence with the replacement text
  596.                          (choose Yes, No or Cancel).
  597.  
  598.      Next Error
  599.      Prev Error
  600.      If any warning or error messages have been captured from the output of
  601.      one of the Project Menu items, the Next and Prev Error menu selections
  602.      allow you to review the error messages and the corresponding source
  603.      code. Double clicking with the mouse on message area of the status bar
  604.      (the area to the right of the INS/OVR indicator) is equivalent to
  605.      choosing Next Error from the Search menu.
  606.  
  607.      View Compiler Output
  608.      If any of the options in the Project Management dialog (choose
  609.      Configure... from the Project menu) were set to "capture output", the
  610.      View Compiler Output command will open a new document window with the
  611.      contents of the captured output file.
  612.  
  613.      Go to line...
  614.      Choose this menu item to jump to a particular line number in your
  615.      document.  After choosing "Go to line", type the appropriate line
  616.      number in the "Go to line" box on the status bar.  Press the Enter key
  617.      and WinEdit will accept the number and move the cursor to the
  618.      beginning of the indicated line.  By default the current line number
  619.      is displayed in the "Go to line" box on the status bar.  There are
  620.      three ways to access the "Goto box" on the status bar:
  621.  
  622.       Press ALT+G on the keyboard.
  623.       Double click on the line and column text on the status bar.
  624.       Choose "Go to line..." from the Search menu.
  625.  
  626.      9
  627.  
  628.  
  629.  
  630.  
  631.      Project Menu Commands         [Standard]
  632.      The commands on this menu allow you to run other programs from within
  633.      WinEdit.  Before compiling your program using the choose the Configure
  634.      menu command to enter the necessary commands to run the
  635.      program/compiler.  Select the Capture Output box and WinEdit will run
  636.      the program you configure and save its output (choose View Compiler
  637.      Output from the Search menu to view compiler errors).  When the
  638.      compilation (Build or Rebuild) finishes, WinEdit will ask if you wish
  639.      to review any warning or error messages, along with the corresponding
  640.      source code.
  641.  
  642.        %f = file name
  643.        %n = base name with no extension
  644.        %e = file extension only
  645.  
  646.      Compile command:    tee.com cl -c -AM -W4 -Zps -Od -DNOCOMM %f
  647.      Make command:  tee.com nmake.com %n
  648.      Rebuild command:    tee.com nmake.com /a %n
  649.      Debug command: cvw %n
  650.      Execute command:    %n
  651.  
  652.       TEE.COM is included with WinEdit and is the DOS equivalent of the
  653.       UNIX TEE.  WinEdit uses TEE.COM to redirect the stdout and stderr to
  654.       a file while also echoing the information to the screen.
  655.  
  656.      Note: WinEdit constructs a batch file to execute from DOS when you
  657.      choose to capture output.  For this reason, when running a Windows
  658.      application from the Run menu, do not choose to capture the output.
  659.  
  660.      Macro Menu Commands
  661.      The macro menu includes a macro recorder (Record Macro) and a listing
  662.      of your recorded macros.  To turn on the macro recorder press Ctrl+R
  663.      from the keyboard or choose Record Macro from the Macro menu.  The
  664.      text "Recording macro" text appears in the lower right corner of the
  665.      status bar.  While the recorder is "on", WinEdit will record your
  666.      keystrokes so that they can later be assigned to a key for quick
  667.      playback.  To turn off the recorder once your macro is complete,
  668.      choose Record Macro again from the Macro menu or press Ctrl+R.
  669.      In the Lite and Standard versions of WinEdit, the recorded macros
  670.      cannot be edited.  You will be prompted for a name for the newly
  671.      recorded macro.  Choose a name in the format MACROx.MAC, where 'x' is
  672.      a digit from 0 to 9.
  673.  
  674.      In the Pro version of WinEdit, macros are recorded as WIL scripts.
  675.      Once the recorder is turned off, the recorded macro script will be
  676.      opened in a new document window.  The proposed filename is MACROx.MAC.
  677.      The default MACRO.MNU script file for the Macro Menu looks for script
  678.      files named MACROx.MAC, where 'x' is a digit from 0 to 9.  To use your
  679.      recorded macro with the default menu, choose File Save As to save this
  680.  
  681.      10
  682.  
  683.      script, replacing the 'x' in the namewith a digit from 0 to 9.
  684.      Alternately, you can give the recorded WIL script any valid filename
  685.      you wish and edit the MACRO.MNU file to reflect the chosen name.
  686.  
  687.      Window Menu Commands
  688.  
  689.      Tile
  690.      Choose Tile from the Windows menu to arrange all of the open windows
  691.      on the screen so that a portion of each windows can be seen.
  692.  
  693.      Cascade
  694.      Choose Cascade to arrange all of the open windows in a stack.  When
  695.      this is done the title bar for each window is visible so that the
  696.      window can be made active by clicking on the title bar.
  697.  
  698.      Next
  699.      Choose Next to change the active window to the next open document
  700.      window.
  701.  
  702.      Arrange Icons
  703.      WinEdit windows that have been minimized appear at the bottom of the
  704.      screen as an icon.  Arrange Icons will place the document window icons
  705.      along the bottom of the window in rows left to right.
  706.  
  707.      Close All
  708.      Closes all open document windows.  If changes have been made to a
  709.      document since it was last saved, you will be prompted to save changes
  710.      before WinEdit closes the file.
  711.  
  712.      Document Names
  713.      Each open window is listed by name at the bottom of the Window menu.
  714.      Choose a window name and the active window will change so that the
  715.      selected window will become the active document window.
  716.  
  717.      Utility Menu Commands         [Professional]
  718.  
  719.      The Utility Menu is a custom menu created with WIL commands.  For
  720.      complete help on using the WIL language, consult the WIL.HLP help
  721.      file.
  722.  
  723.      The menu items on the Utility Menu and the functions behind them are
  724.      totally configurable.  The WINEDIT.MNU file contains the menu item
  725.      text and the WIL language functions behind them.  To edit this file
  726.      and thus edit the Utility Menu, choose "Edit Utility Menu" from the
  727.      Utility Menu.
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.      11
  738.  
  739.  
  740.  
  741.  
  742.      WinEdit Procedures
  743.  
  744.      Changing Printers and Printer Options
  745.      Select Printer Setup from the File menu to change settings in the
  746.      printer setup dialog for your installed Windows printer drivers.
  747.      Select a printer driver and choose the Setup button to access the
  748.      printer driver options (the resulting dialog .
  749.  
  750.      Select Page Setup from the File menu to change the following WinEdit
  751.      page settings:
  752.  
  753.        Margins
  754.        Header and/or footer text
  755.        The printer font
  756.        Page layout (one or two pages up)
  757.  
  758.      WinEdit will remember your page settings from session to session.
  759.  
  760.      Compiling (Running other programs)      [Standard]
  761.      The first five commands on the Project menu are user-configurable
  762.      commands to execute another program.  You may configure these commands
  763.      to execute any .EXE  or .BAT program by typing the command text in the
  764.      appropriate Configure... edit box..
  765.  
  766.      For example a sample compile line may read:
  767.  
  768.           tee.com cl -c -AM -W4 -Zps -Od -DNOCOMM %f
  769.  
  770.      If the program supports DOS redirection (as most compilers and linkers
  771.      do) you can select the Capture Output box to have WinEdit capture the
  772.      program's output in a file.  When the program has executed, WinEdit
  773.      will allow you to review any messages generated, along with the
  774.      corresponding source code.
  775.  
  776.      The following wildcards are provided so that filenames in the Project
  777.      Management dialog do not need to be changed when compiling different
  778.      files:
  779.  
  780.        %f = file name
  781.        %n = base name, no extension
  782.        %e = file extension only
  783.  
  784.      If you select the Capture Output box, WinEdit will run the program you
  785.      configure and save its output.  When the program finishes, WinEdit
  786.      will ask if you wish to review any warning or error messages, along
  787.      with the corresponding source code.
  788.  
  789.      WinEdit constructs a batch file to execute from DOS when you choose to
  790.      capture output.  For this reason, when running a Windows application
  791.  
  792.      12
  793.  
  794.      from the Run menu, do not choose to capture the output.  In this case,
  795.      just indicate the EXE to run in the Execute command edit box (such as
  796.      Cardfile).  To run the exe listed in the Execute command edit box, do
  797.      one of the following:
  798.  
  799.     1. Choose the traffic light button on the Control Bar.
  800.     2. Press ALT+F7 from the keyboard.
  801.     3. Choose Execute from the Project menu.
  802.  
  803.      Control Bar
  804.  
  805.      The Control Bar allows you to access some frequently used commands by
  806.      clicking on an icon button along the top of the window.  The function
  807.      of the buttons left to right is as follows:
  808.  
  809.      Icon Buttons
  810.      Open       Access the File Open dialog.
  811.      Save       Saves the contents of the document window to disk.
  812.      File List  Reopen a file from a listing of the last open files.
  813.      Print      Prints the contents of the document window.
  814.      Undo       Restores the previous editing action.
  815.      Redo       Restores the previous undo action.
  816.      Cut        Cuts your selected text to the clipboard.
  817.      Copy       Copy your selected text to the clipboard.
  818.      Paste      Pastes the contents of the clipboard at the cursor
  819.      location.
  820.      Find       Finds specified text in the document.
  821.      Find Next  Finds text in the document using the previously entered
  822.                 search string.
  823.      Change     Allows you to change text (search and replace).
  824.      Compile    Compile.
  825.      Make       Make.
  826.      Rebuild    Rebuild.  (Visible only on SuperVGA or above resolution
  827.                 displays)
  828.      Debug      Debug.
  829.      Execute    Executes your program from WinEdit.
  830.      Previous   Previous Error.
  831.      Next       Next Error.
  832.      Help       Keyword Help (Extended Help).
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.      13
  849.  
  850.  
  851.  
  852.  
  853.      The Control Bar along the top of the WinEdit screen can be resized and
  854.      repositioned anywhere on the screen.  Click the left mouse button on
  855.      the Control Bar and pull downward to "tear" the Control Bar from the
  856.      top of the window (the mouse cursor will change to a box with the text
  857.      TEAR).  Let go of the mouse button and the Control Bar is now floating
  858.      on top of the WinEdit screen.  Position your mouse over the edge of
  859.      the bar and you can resize the bar just as you can document windows.
  860.      The Control Bar can be docked along any window edge.  So if you'd like
  861.      you can "dock" the control bar on the left of the WinEdit window.  To
  862.      dock the bar, click in the middle of the Control Bar and move your
  863.      cursor to the middle of the top, left, right or bottom window edge.
  864.      Move your mouse cursor until the cursor changes from "TEAR" to "DOCK".
  865.      Once your cursor reads "DOCK" release the left mouse button to dock
  866.      the Control Bar along the window edge.
  867.  
  868.      You can turn the Control Bar on or off at any time from the File
  869.      Preferences menu (mark or unmark the Show Control Bar check box).
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.      14
  905.  
  906.      Editing Text
  907.  
  908.      To "copy and paste", or "cut and paste" the selected text, do the
  909.      following:
  910.  
  911.      1.Select the text to copy or cut.
  912.  
  913.      2.Choose Copy from the Edit menu to copy the selected text to the
  914.        clipboard.  Or choose Cut from the Edit menu to cut the text to the
  915.        clipboard.
  916.  
  917.      3.Move the insertion point where you want the text to appear.  Or if
  918.        you want to replace a section of text with the contents of the
  919.        clipboard, select the text in the document that you want replaced.
  920.  
  921.      4.Choose Paste from the Edit menu.
  922.  
  923.      Editing Shortcuts:
  924.  
  925.       Keypad + (Plus)
  926.       Copies the current line to the clipboard if nothing is selected or
  927.       if there is a selection, the + key functions the same as Edit Copy
  928.       (CTRL+INS).
  929.  
  930.       Keypad - (Minus)
  931.       Cuts the current line to the clipboard if nothing is selected or if
  932.       there is a selection, the - key is the same as Edit Cut (SHIFT+DEL).
  933.  
  934.      Deleting Text
  935.      To delete text without sending it to the Windows clipboard, do the
  936.      following:
  937.  
  938.      1.Select the text to delete.
  939.  
  940.      2.Choose Delete from the Edit menu or press the Del key from the
  941.        keyboard.
  942.  
  943.      If no text is selected, Edit Delete will delete the character to the
  944.      right of the cursor.  To delete characters to the left of the cursor
  945.      use the Backspace key.
  946.  
  947.      Tab and SHIFT Tab
  948.      Press the Tab key to insert a number of spaces and bring the cursor to
  949.      the next tab stop.  The number of spaces inserted when the tab key is
  950.      pressed is configurable in File Preferences (choose any value from 1
  951.      to 12).  For example if the "Tab Size" is set to 3 in File
  952.      Preferences, pressing the Tab key will advance the cursor three spaces
  953.      to the right.
  954.  
  955.      The SHIFT+Tab key combination moves the current position back to the
  956.      previous tab stop (to the left).  For example if the "Tab Size" is set
  957.      to 3 in File Preferences, pressing the SHIFT+Tab key combination will
  958.      move the cursor three spaces/positions to the left.
  959.  
  960.      15
  961.  
  962.  
  963.  
  964.  
  965.      If any text is selected, the Tab and SHIFT+Tab keys will shift every
  966.      line in the selection forwards (Tab) or backwards (SHIFT+Tab) by one
  967.      tab stop.
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.      16
  1016.  
  1017.      Working With Multiple Documents
  1018.  
  1019.      WinEdit allows you to open multiple documents and switch back and
  1020.      forth from document to document.  To open a new document, choose New
  1021.      from the File menu and a new, untitled document window will appear.
  1022.      To load an existing document/file, choose Open from the File menu.
  1023.      Chose the file type you would like to open from the list box labeled
  1024.      "List Files of Type:".
  1025.  
  1026.      There are selections for source files (*.c;*.h;*.rc;*.def), text files
  1027.      (*.txt) and all files regardless of file extensions (*.*).  Change to
  1028.      the appropriate drive and directory and double click on the file to
  1029.      open or select the file name and choose the OK button.
  1030.  
  1031.      Once you have several windows/files open, you can view a list of the
  1032.      open windows by pressing ALT+W.  The open files (drives and
  1033.      subdirectory paths included) are listed at the bottom of the Window
  1034.      menu.  The active window is indicated by the check mark before the
  1035.      file name.  Choose any of the windows listed to change the active
  1036.      window.
  1037.  
  1038.      Additionally, Tile and Cascade are available from the Windows menu to
  1039.      change the arrangement of the windows.  Choose Cascade to arrange all
  1040.      of the open windows in a stack.  When this is done the title bar for
  1041.      each window is visible so that the window can be made active by
  1042.      clicking on the title bar.  Choose Tile from the Windows menu to
  1043.      arrange all of the open windows on the screen so that a portion of
  1044.      each windows can be seen.
  1045.  
  1046.      All of the document windows can also be sized and minimized.  To size
  1047.      the document window, move the mouse over a window edge so that the
  1048.      mouse cursor changes to a double sided arrow.  Now, click the drag the
  1049.      mouse to change the size of the window.  To minimize a document
  1050.      window, click on the down arrow in the upper right corner of the
  1051.      document window.  The windows will appear at the bottom of the WinEdit
  1052.      screen as a icon (appears as a white piece of paper).  To restore the
  1053.      document window back to its original size, double click on the icon.
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.      17
  1072.  
  1073.  
  1074.  
  1075.  
  1076.      Extended Help       [Standard]
  1077.  
  1078.      Press SHIFT+F1 or hold the SHIFT key and click the Right mouse button
  1079.      on any Windows SDK function, message, or data structure name and
  1080.      WinEdit will access the help system topic for that item.
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.      18
  1127.  
  1128.      Finding Text
  1129.  
  1130.      Choose Find from the Search menu to search for text within the active
  1131.      document.
  1132.  
  1133.      You can specify the following options:
  1134.  
  1135.      * Find              Type the text you want to find.
  1136.      * Match Upper/
  1137.        Lower Case        Select this box to match the upper and lower case
  1138.                          exactly.
  1139.      * Regular
  1140.        Expressions       Select this box to use regular expressions.
  1141.      * Forward           Search forward in the document starting at the
  1142.                          insertion point.
  1143.      * Backward          Search backward in the document starting at the
  1144.                          insertion point.
  1145.  
  1146.      Choose Repeat Last Find (or press CTRL+F5) to repeat the last search
  1147.      using the same options as the previous search, without opening the
  1148.      Find dialog box again.
  1149.  
  1150.      Choose Change from the Search menu to search for text in a document
  1151.      and replace the found text with text you specify.
  1152.  
  1153.      You can specify the following options:
  1154.  
  1155.      * Find              Type the text you want to find in the document.
  1156.      * Replace with      Type the text you want to insert in place of the
  1157.                          found text.
  1158.      * Match case        Select this box to match the upper and lower case
  1159.                          exactly.
  1160.      * Regular
  1161.        Expressions       Select this box to use regular expressions.
  1162.      * Search backwards  Search backward through the document starting at
  1163.                          the insertion point.
  1164.      * Confirm before
  1165.        changing          When the search text is found, you will be asked
  1166.                          if you want to change the occurrence with the
  1167.                          replacement text (choose Yes, No or Cancel).
  1168.      * Change All        When this option is selected, WinEdit will start
  1169.                          at the current cursor position and search the
  1170.                          entire document.  If the "Confirm before changing"
  1171.                          box is selected, you will be asked if you want to
  1172.                          change the occurrence with the replacement text
  1173.                          (choose Yes, No or Cancel).
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.      19
  1183.  
  1184.      Using Regular Expressions
  1185.  
  1186.      A regular expression is a search or replace string that uses special
  1187.      characters to match text patterns.  WinEdit supports UNIX style
  1188.      regular expressions.
  1189.  
  1190.      When WinEdit conducts a search using regular expressions, it must
  1191.      check character by character in your text.  For this reason, searches
  1192.      using regular expressions are slower than regular searches.
  1193.      The following table describes the regular expression characters
  1194.      recognized by WinEdit.
  1195.  
  1196.      Expression Description
  1197.       \         Escape. WinEdit will ignore any special meaning of the
  1198.                 character that follows the Escape expression.  Use the
  1199.                 Escape if you need to search for a literal character that
  1200.                 matches a regular expression character.
  1201.       .         Wild Card. Matches any character.  For example, the
  1202.                 expression 'X.X' will match 'XaX', 'XbX, and 'XcX', but
  1203.                 not 'XaaX'.
  1204.       ^         Beginning Of Line. The expression matches only if it
  1205.                 occurs at the beginning of a line.  For example, '^for'
  1206.                 matches the text 'for' only when it occurs at the
  1207.                 beginning of a line.
  1208.       $         End Of Line. The expression matches only if it occurs at
  1209.                 the end of a line.  For example, '(void)$' matches the
  1210.                 text '(void)' only when it occurs at the end of a line.
  1211.       [ ]       Character Class. The expression matches any character in
  1212.                 the class specified within the brackets.  Use a dash (-)
  1213.                 to specify a range of character values. For example, '[a-
  1214.                 zA-Z0-9]' matches any letter or number, and '[xyz]'
  1215.                 matches 'x', 'y', or 'z'.
  1216.       [ ^ ]     Inverse Class. The expression matches any character not
  1217.                 specified in the class.  For example, '[^a-zA-Z]' matches
  1218.                 any character that is not a letter.
  1219.       *         Repeat Operator. Matches zero or more occurrences of the
  1220.                 character that precedes the '*'.  For example, 'XY*X'
  1221.                 matches 'XX', 'XYX', and 'XYYX.
  1222.       +         Repeat Operator. Matches one or more occurrences of the
  1223.                 character that precedes the '+'.  For example, 'XY+X'
  1224.                 matches 'XYX' and 'XYYX, but not 'XX'.
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.      20
  1239.  
  1240.  
  1241.  
  1242.  
  1243.      Windows 3.1 Support
  1244.  
  1245.      "Drag and Drop"
  1246.      WinEdit is fully compatible with Windows version 3.1.  WinEdit version
  1247.      2.0 adds support for drag and drop from File Manager.  To open files
  1248.      in WinEdit, simply drag and drop one or more files from the Windows
  1249.      File Manager onto WinEdit.  Drag and drop from File Manager is
  1250.      functional when WinEdit is either minimized or maximized.
  1251.  
  1252.      "Sounds"
  1253.      Whenever a Message Box comes up, WinEdit plays the WAVE file
  1254.      corresponding to the Message Box icon under Multimedia Windows or the
  1255.      Asterisk event under Windows 3.1.  Under Windows Win 3.0 the standard
  1256.      beep will play.  "Warning Sounds" is an option in File Preferences
  1257.      dialog and can be disabled if you'd like.  There is also a WinEdit
  1258.      Startup event that can be configured for any WAVE file when operating
  1259.      under Windows 3.1 or Multimedia Windows (sound card required).
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.      21
  1294.  
  1295.      Printing Documents
  1296.  
  1297.      Choose Print from the File menu to send the text of the current
  1298.      document to the active printer.  All print options such as the layout
  1299.      (one up portrait printing or two page landscape printing) and printer
  1300.      font, are set in the Page Setup dialog (accessible from the File
  1301.      menu).  The default printer selection is made in the Windows Control
  1302.      Panel Printers section.
  1303.  
  1304.      When choosing Print, the entire contents of the document file is sent
  1305.      to the printer.  To print only a selection of text, do the following:
  1306.  
  1307.     1. Select the text to print.
  1308.  
  1309.     2. Choose Copy from the Edit menu.
  1310.  
  1311.     3. Choose New from the File menu.
  1312.  
  1313.     4. Choose Paste from the Edit menu to paste the contents of the
  1314.        clipboard.
  1315.  
  1316.     5. Select the printer button on the Control Bar or choose Print from
  1317.        the File menu.
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.      22
  1350.  
  1351.  
  1352.  
  1353.  
  1354.      Saving Documents
  1355.  
  1356.      To save a document to disk under the current file name (the filename
  1357.      appears in the title bar for the document window), choose Save from
  1358.      the File menu.  If the file has not been saved before, WinEdit will
  1359.      prompt for a file name.  To save a document to a new name and/or
  1360.      location, choose Save As from the File menu.
  1361.  
  1362.      Backup Files
  1363.      By default, when a file is saved in WinEdit, the previous version of
  1364.      the document is renamed with a .BAK file extension.  For example, if
  1365.      you make changes to FILENAME.TXT and choose to save the file, the
  1366.      previous version of the file is renamed to FILENAME.BAK while the new
  1367.      changes are saved to FILENAME.TXT.  The backup file (FILENAME.BAK) is
  1368.      saved to the same directory as FILENAME.TXT.
  1369.  
  1370.      You can customize the backup file specification with the
  1371.      Preferences... command on the File menu.
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.      23
  1405.  
  1406.      Setting Preferences
  1407.  
  1408.      The WinEdit program preferences are accessible by choosing Preferences
  1409.      from the File menu.
  1410.  
  1411.      To change the screen font used to display document text, choose the
  1412.      button labeled Screen Font.  In the resulting dialog choose a font
  1413.      name from the listing of fixed spaced screen fonts on your system.  In
  1414.      addition to the typeface, there are four styles to choose from:
  1415.      Regular, Italic, Bold and Bold Italic.  Select a style a point size
  1416.      for your on screen text.
  1417.  
  1418.      The File Filter dialog allows you to enter a series of file filters
  1419.      used in the File Open and File Save As dialog boxes.  The format of
  1420.      the filter string is
  1421.  
  1422.         <description>|<mask>|<description>|mask|<description>|mask|
  1423.  
  1424.      Backup Specification determines where or whether WinEdit will make a
  1425.      backup copy of saved files.  The default specification is '%n.bak'.
  1426.      %n is a placeholder for the base file name.  To prevent WinEdit from
  1427.      making backup files, delete the text from this edit box.  To force all
  1428.      backup files into one directory, add a directory to the specification.
  1429.      For example, to save all backup files in the C:\TEMP directory, enter
  1430.      'C:\TEMP\%n.BAK' as the backup specification.  To save backup files in
  1431.      the same directory as the original file, but with an extension of
  1432.      'XXX', enter '%n.XXX'.
  1433.  
  1434.      The Tab Size list box allows you to set the number of spaces you would
  1435.      like to be inserted into your document, each time you press the tab
  1436.      key.  Values range from one space to twelve spaces per tab.
  1437.  
  1438.      The "Reopen last file at startup" is helpful if you usually start
  1439.      working were you left off in your last WinEdit session.  If this
  1440.      option is selected, the last file open in WinEdit will be opened
  1441.      automatically the next time WinEdit is started.  If this option is not
  1442.      selected, WinEdit will open with no windows open (use the File New or
  1443.      File Open command to begin working in WinEdit).
  1444.  
  1445.      The "Zoom window at startup" option determines the size of the
  1446.      document window on startup of WinEdit.  If the "Zoom" option is
  1447.      selected, then the WinEdit program will start with the document window
  1448.      zoomed out so that it fills the WinEdit program area.  If the "Zoom"
  1449.      option is not selected in File Preferences, then the WinEdit document
  1450.      window will not fill the WinEdit program area.
  1451.  
  1452.      The Show Control Bar option simply toggles the Control Bar of buttons
  1453.      On (if selected) or Off if not selected in File Preferences.
  1454.  
  1455.      The "Warning sounds" option plays the WAVE file corresponding to the
  1456.      Message Box icon under Multimedia Windows or Windows 3.1, whenever a
  1457.      Message Box pops up such as search text not found.  Under Windows
  1458.      version 3.0, the standard system beep will sound.
  1459.  
  1460.      24
  1461.  
  1462.  
  1463.  
  1464.  
  1465.      Setting Margins, Headers and Footers
  1466.  
  1467.      Headers and Footers
  1468.      Choose Page Setup from the File menu to configure header and footer
  1469.      text.  Type the text you wish to appear at the top and bottom of each
  1470.      page.
  1471.  
  1472.      You can use the following special characters in headers and footers:
  1473.  
  1474.      * %f                The document name will appear.
  1475.      * %d                The date and time of the printout will appear.
  1476.      * %p                The page number will appear.
  1477.  
  1478.      The default header text is "%f - %d" or Document Name - Date and Time
  1479.      of the printout.
  1480.  
  1481.      The default footer text is "Page %p" or Page 1.
  1482.  
  1483.      Changes made to the header and footer text are remembered for the next
  1484.      session of WinEdit.
  1485.  
  1486.      Margins
  1487.      Choose Page Setup from the File menu to change the margins used for
  1488.      WinEdit's printouts.  You can enter the measurements for top, bottom,
  1489.      left, and right margins.  The margin values are either in inches or
  1490.      centimeters, depending upon the Measurement setting in the Windows
  1491.      Control Panel International section/icon.
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.      25
  1516.  
  1517.      Undo and Redo
  1518.  
  1519.      Undo
  1520.      Allows you to "undo" previous editing actions.  WinEdit can undo the
  1521.      following edits:
  1522.  
  1523.           Inserting a character.
  1524.           Deleting a character.
  1525.           Cutting a selection.
  1526.           Pasting a selection.
  1527.  
  1528.      WinEdit can undo the last 2000 editing actions.  Press ALT+Backspace
  1529.      to undo the last editing action or select Undo from the Edit menu.
  1530.  
  1531.      Redo
  1532.      Allows you to reverse any Undo command.  If you undo an editing action
  1533.      by mistake, you can "redo" the edit.  Press CTRL+Backspace to redo the
  1534.      last editing action or choose Redo from the Edit menu.
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.      26
  1572.  
  1573.  
  1574.  
  1575.  
  1576.      WinEdit Project Files         [Standard]
  1577.  
  1578.      Information entered into the Project Management dialog (choose
  1579.      Configure... from the Project menu) can be saved in a private INI file
  1580.      with a .WPJ (WinEdit Project File) extension.  Choose the Save...
  1581.      pushbutton to save the contents of the dialog box in a .WPJ file.  The
  1582.      default save path for the WPJ files is the Windows directory.  After
  1583.      creating several project files you can load an existing .WPJ file by
  1584.      clicking on the Open... pushbutton.
  1585.  
  1586.      There are five edit boxes for your Compile, Make, Rebuild, Debug and
  1587.      Execute command line information.  The following wildcards are
  1588.      provided so that filenames in the Project Management dialog do not
  1589.      need to be changed when compiling different files:
  1590.  
  1591.        %f = file name
  1592.        %n = base name, no extension
  1593.        %e = file extension only
  1594.  
  1595.      If you select the Capture Output box, WinEdit will run the program you
  1596.      configure and save its output.  When the program finishes, WinEdit
  1597.      will ask if you wish to review any warning or error messages, along
  1598.      with the corresponding source code.  WinEdit constructs a batch file
  1599.      to execute from DOS when you choose to capture output.  For this
  1600.      reason, when running a Windows application from the Run menu, do not
  1601.      choose to capture the output.
  1602.  
  1603.      The Project Name field can be filled with a brief description of the
  1604.      project.  The Working Directory field sets the default open and save
  1605.      directories for your project to the path indicated in this field.
  1606.      Note: The last project file open in WinEdit, will automatically be
  1607.      loaded the next time you start WinEdit.  To change to another project
  1608.      file, choose Configure... from the Project menu and choose the Open...
  1609.      pushbutton.
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.      27
  1627.  
  1628.      WinEdit Extensions       [Standard]
  1629.  
  1630.      A WinEdit Extension DLL is a dynamic-link library (DLL) that contains
  1631.      a pre-defined entry point that processes menu commands and
  1632.      notification messages sent by WinEdit.  You can redefine WinEdit's
  1633.      menus and accelerators and write new functions which access WinEdit
  1634.      functions directly.
  1635.  
  1636.      Creating a WinEdit Extension
  1637.      A WinEdit Extension DLL must be named WE_EXT.DLL and must include a
  1638.      standard entry point, the WE_ExtensionProc function. It must include
  1639.      the WE_EXT.H header file that defines WinEdit messages and structures.
  1640.      WinEdit communicates with the Extension DLL by sending messages to the
  1641.      DLL's WE_ExtensionProc function.
  1642.  
  1643.        The WE_ExtensionProc function is defined as follows:
  1644.  
  1645.      WE_ExtensionProc(HWND hWnd,     /* WinEdit's window handle */
  1646.                       HANDLE hInst,  /* instance identifier     */
  1647.                       UINT wParam,   /* command ID              */
  1648.                       LONG lParam)   /* additional information  */
  1649.  
  1650.       The hWnd parameter identifies the main WinEdit window.  This window
  1651.       handle is used in most of the extension functions, and should also
  1652.       be used as the parent window for any child windows, dialog boxes, or
  1653.       message boxes created.
  1654.  
  1655.       The hInst parameter is the HINSTANCE of the Extension DLL.  This
  1656.       parameter is used when retrieving resources from the DLL.
  1657.       The wParam parameter contains the message ID, which may be a command
  1658.       ID from a menu or accelerator, a notification message from WinEdit,
  1659.       or a request for information from WinEdit.
  1660.  
  1661.       The lParam parameter is used in some messages to pass additional
  1662.       information to the Extension DLL.
  1663.  
  1664.      Loading the Extension
  1665.  
  1666.       WinEdit searches the current directory and the path for WE_EXT.DLL,
  1667.       and explicitly loads the Extension DLL if it is found.  If the DLL
  1668.       is successfully loaded, WinEdit then sends the following
  1669.       notification and request messages to the Extension DLL:
  1670.  
  1671.           WEN_LOADMENU
  1672.             This message is a request for a menu handle to be used as the
  1673.             main WinEdit menu.  If the Extension DLL returns a handle to a
  1674.             menu as the return value for this message, WinEdit uses that
  1675.             menu.  If the Extension DLL returns 0, the standard WinEdit
  1676.             menu is used.
  1677.  
  1678.           WEN_LOADSHORTMENU
  1679.             This message is a request for a menu handle to be used as the
  1680.             "No file" menu.  WinEdit displays this menu whenever no MDI
  1681.  
  1682.      28
  1683.  
  1684.  
  1685.  
  1686.  
  1687.             child windows are open.  If the Extension DLL returns a handle
  1688.             to a menu as the return value for this message, WinEdit uses
  1689.             that menu.  If the Extension DLL returns 0, the standard
  1690.             WinEdit menu is used.
  1691.  
  1692.           WEN_LOADACCELS
  1693.             This message is a request for a handle to an accelerator table.
  1694.             If the Extension DLL returns a handle to an accelerator table
  1695.             as the return value for this message, WinEdit will use that
  1696.             accelerator table.  If the Extension DLL returns 0, the
  1697.             standard WinEdit accelerator table is used.
  1698.  
  1699.           WEN_GETWINDOWMENU
  1700.             If the Extension DLL returned a menu handle in the WEN_LOADMENU
  1701.             message, this message will be sent to obtain the handle to the
  1702.             Window popup menu.  WinEdit uses this menu handle to append MDI
  1703.             child window names to.
  1704.  
  1705.           WEN_INITMENU
  1706.             This message is sent before showing any drop down menu items.
  1707.             Respond by setting any check marks, graying any inapplicable
  1708.             items, etc.
  1709.  
  1710.           WEN_RBUTTONDOWN
  1711.             This message is sent when the right mouse button is clicked in
  1712.             an MDI child window.
  1713.  
  1714.           WEN_RBUTTONDOWNC
  1715.             This message is sent when the right mouse button is clicked
  1716.             while the control key is down in an MDI child window.
  1717.  
  1718.           WEN_RBUTTONDOWNS
  1719.             This message is sent when the right mouse button is clicked
  1720.             while the shift key is down in an MDI child window.
  1721.  
  1722.           WEN_RBUTTONDOWNSC
  1723.             This message is sent when the right mouse button is clicked
  1724.             while the control key and the shift keys are down in an MDI
  1725.             child window.
  1726.  
  1727.           WEN_END
  1728.             This message is sent before the DLL is unloaded.  Any cleanup
  1729.             processing should be done, such as releasing allocated memory.
  1730.  
  1731.      Processing Menu Selections
  1732.  
  1733.       A WinEdit Extension DLL's menu resource can include two levels of
  1734.       menu identifiers.  Identifiers in the range of WE_EXTFIRST through
  1735.       WE_EXTLAST (defined in WE_EXT.H) are sent to the Extension DLL for
  1736.  
  1737.      29
  1738.  
  1739.       processing.  Other identifiers defined in WE_EXT.H that begin with
  1740.       IDM_ are internal WinEdit commands that WinEdit handles without
  1741.       calling the Extension DLL.
  1742.       When designing menus or accelerators, use the IDM_ identifiers for
  1743.       predefined functions which WinEdit will handle without further
  1744.       processing by your Extension DLL.  Use identifiers in the range of
  1745.       WE_EXTFIRST through WE_EXTLAST for functions you define.  When the
  1746.       user selects a menu item or presses an accelerator key which is
  1747.       defined with an identifier in that range, WinEdit will pass the
  1748.       message on to the Extension DLL for processing.  The following code
  1749.       example shows a simple example of a user-defined function being
  1750.       called:
  1751.         #define EXT_EXAMPLE  WE_EXTFIRST+1
  1752.         .
  1753.         .
  1754.         .
  1755.         switch (wParam)
  1756.            {
  1757.            case EXT_EXAMPLE:
  1758.               return MyFunction();
  1759.               break;
  1760.      Initializing the Extension Menu
  1761.       Whenever the user selects a menu item, WinEdit sends the
  1762.       WEN_INITMENU message to the Extension DLL. The Extension DLL should
  1763.       respond to this message by adding check marks or disabling or
  1764.       enabling items.  If the Extension DLL did not load its own menu, it
  1765.       can ignore this message.
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.      30
  1794.  
  1795.  
  1796.  
  1797.  
  1798.      WinEdit Extension Example
  1799.  
  1800.      The following example shows a minimal WinEdit Extension DLL's
  1801.      WE_ExtensionProc function.  The Extension DLL loads its own menus and
  1802.      accelerator table, and defines one new command.
  1803.  
  1804.      #include <windows.h>
  1805.      #include "we_ext.h"
  1806.  
  1807.      #define MACROMENU   4   /* position of macro menu  (0 based)      */
  1808.      #define WINDOWMENU  5   /* position of window menu (0 based)      */
  1809.      #define EXT_EXAMPLE   WE_EXTFIRST+1
  1810.  
  1811.      UINT FAR PASCAL WE_ExtensionProc(HWND hWnd,
  1812.                                       HANDLE hInst,
  1813.                                       UINT wParam,
  1814.                                       LONG lParam)
  1815.         {
  1816.         switch (wParam)
  1817.            {
  1818.            case WEN_LOADMENU:
  1819.  
  1820.               /*  This is the menu WinEdit will display when there
  1821.                *  is at least one document window open.  Return NULL
  1822.                *  to use the default WinEdit menu.
  1823.                */
  1824.               return (UINT)LoadMenu(hInst, "MyMenu");
  1825.               break;
  1826.  
  1827.            case WEN_LOADSHORTMENU:
  1828.  
  1829.               /*  this is the menu WinEdit will display when there
  1830.                *  are no document windows open.  Return NULL
  1831.                *  to use the default WinEdit menu.
  1832.                */
  1833.                  return (UINT)LoadMenu(hInst, "MyShortMenu");
  1834.                  break;
  1835.  
  1836.            case WEN_LOADACCELS:
  1837.  
  1838.               /*  To re-define the WinEdit command keys, load your
  1839.                *  own accelerator table here.  Return NULL to
  1840.                *  use the default WinEdit accelerators.
  1841.                */
  1842.               return (UINT)LoadAccelerators (hInst,"MyAccels");
  1843.               break;
  1844.  
  1845.            case WEN_GETWINDOWMENU:
  1846.  
  1847.  
  1848.      31
  1849.  
  1850.               /*  WinEdit needs the handle of the submenu to
  1851.                *  append MDI document names to.  The hWnd parameter
  1852.                *  is used to send the handle to the main menu.
  1853.                *  This message will not be sent if you return
  1854.                *  NULL to the WEN_LOADMENU message.
  1855.                */
  1856.               return (UINT)GetSubMenu ((HMENU)hWnd, WINDOWMENU);
  1857.               break;
  1858.  
  1859.            case WEN_END:
  1860.  
  1861.               /*  WinEdit is shutting down.  Do any clean-up processing
  1862.                *  here.
  1863.                */
  1864.               return TRUE;
  1865.               break;
  1866.  
  1867.            case WEN_INITMENU:
  1868.  
  1869.               /*  This message is sent before showing any drop down
  1870.                *  menu items.  Respond by setting any checkmarks,
  1871.                *  graying any inapplicable items, etc.
  1872.                */
  1873.               {
  1874.               POINT ptStart,ptEnd;
  1875.               HMENU hCurrentMenu;
  1876.               UINT  wStatus;
  1877.  
  1878.               hCurrentMenu = GetMenu(hWnd);
  1879.  
  1880.               /*  if there is a current selection, enable the cut & copy
  1881.                *  commands.
  1882.                */
  1883.               wStatus = (UINT)edGetSelectionState(hWnd, &ptStart, &ptEnd);
  1884.               if (!wStatus)
  1885.                  wStatus = MF_GRAYED;
  1886.               else
  1887.                  wStatus = MF_ENABLED;
  1888.               EnableMenuItem(hCurrentMenu, IDM_EDITCUT,  wStatus);
  1889.               EnableMenuItem(hCurrentMenu, IDM_EDITCOPY, wStatus);
  1890.  
  1891.               /*  if there is text on the clipboard, enable the paste
  1892.                *  command.
  1893.                */
  1894.               if (OpenClipboard(hWnd))
  1895.                  {
  1896.                  if (IsClipboardFormatAvailable(CF_TEXT)
  1897.                        || IsClipboardFormatAvailable(CF_OEMTEXT))
  1898.                     EnableMenuItem(hCurrentMenu, IDM_EDITPASTE, MF_ENABLED);
  1899.                  else
  1900.                     EnableMenuItem(hCurrentMenu, IDM_EDITPASTE, MF_GRAYED);
  1901.                  CloseClipboard();
  1902.                  }
  1903.  
  1904.      32
  1905.  
  1906.  
  1907.  
  1908.  
  1909.               else
  1910.                  EnableMenuItem(hCurrentMenu, IDM_EDITPASTE, MF_GRAYED);
  1911.  
  1912.               /* set the Undo, Redo, Insert, and WordWrap menu items */
  1913.               wStatus = (UINT)edGetUndoState(hWnd);
  1914.               if (!wStatus)
  1915.                  wStatus = MF_GRAYED;
  1916.               else
  1917.                  wStatus = MF_ENABLED;
  1918.               EnableMenuItem(hCurrentMenu, IDM_EDITUNDO, wStatus);
  1919.  
  1920.               wStatus = (UINT)edGetRedoState(hWnd);
  1921.               if (!wStatus)
  1922.                  wStatus = MF_GRAYED;
  1923.               else
  1924.                  wStatus = MF_ENABLED;
  1925.               EnableMenuItem(hCurrentMenu, IDM_EDITREDO, wStatus);
  1926.  
  1927.               wStatus = (UINT)edGetWordWrapState(hWnd);
  1928.               if (!wStatus)
  1929.                  wStatus = MF_UNCHECKED;
  1930.               else
  1931.                  wStatus = MF_CHECKED;
  1932.               CheckMenuItem (hCurrentMenu, IDM_EDITTOGGLEWRAP,
  1933.      MF_BYCOMMAND|wStatus);
  1934.  
  1935.               wStatus = (UINT)edGetInsertState(hWnd);
  1936.               if (!wStatus)
  1937.                  wStatus = MF_UNCHECKED;
  1938.               else
  1939.                  wStatus = MF_CHECKED;
  1940.               CheckMenuItem (hCurrentMenu, IDM_EDITTOGGLEINS,
  1941.      MF_BYCOMMAND|wStatus);
  1942.  
  1943.               return TRUE;   /* we handled it, don't return 0 */
  1944.               break;
  1945.               }
  1946.  
  1947.            /*  You can define your own commands in the range
  1948.             *  WE_EXTFIRST to WE_EXTLAST that can be attached to
  1949.             *  menu items or accelerators.
  1950.             */
  1951.            case EXT_EXAMPLE:
  1952.               MessageBox(hWnd,"Example command","WinEdit Extension",
  1953.                          MB_ICONINFORMATION|MB_OK);
  1954.               return TRUE;
  1955.               break;
  1956.  
  1957.            default:
  1958.  
  1959.      33
  1960.  
  1961.               /* return NULL to all messages not processed. */
  1962.               break;
  1963.  
  1964.            }  /* end switch (wParam) */
  1965.  
  1966.         return NULL;
  1967.         }
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.      34
  2015.  
  2016.  
  2017.  
  2018.  
  2019.      Configuring the Utility Menu       [Professional]
  2020.  
  2021.      The Utility Menu is a custom menu created with WIL language extension
  2022.      commands.  The menu items on the Utility Menu and the functions behind
  2023.      them are totally configurable.  The WINEDIT.MNU file contains the menu
  2024.      item text and the WIL language functions behind them.  The functions
  2025.      are made up of statements, constants, and variables, much like any
  2026.      programming language.  To edit the Utility Menu file choose "Edit
  2027.      Utility Menu" from the Utility Menu.
  2028.  
  2029.      In the WINEDIT.MNU file, the menu item text that appears below the
  2030.      Utility Menu begins in Column one of the text file.  Commands for the
  2031.      menu item are at least 8 spaces to the right below the menu text.  In
  2032.      the example below, "File Open with prompt" is the text that will
  2033.      appear on the Utility Menu and the "WFileOpen("")" command will be
  2034.      executed if the menu item is selected.
  2035.  
  2036.      File Open with prompt    ; Open a document file via dialog box
  2037.              WFileOpen("")
  2038.  
  2039.      To create a pop-out submenu, add one space before the menu title for
  2040.      every item of the main menu.  For example, "Accessories" will appear
  2041.      on the Utility Menu with "Appointment Scheduling" and "Calculator"
  2042.      appearing as pop out menu selections.
  2043.  
  2044.      Accessories
  2045.       Appointment Scheduling
  2046.                 run("Calendar.exe","")
  2047.       C&alculator
  2048.                 run("calc.exe","")
  2049.  
  2050.      Adding an ampersand before any letter in the title causes that letter
  2051.      to be displayed underlined.  Such underlined letters are recognized by
  2052.      Windows as menu hot keys accessed through an ALT+letter key
  2053.      combination.
  2054.  
  2055.      For more complete information on the WIL language and WIL scripts.
  2056.      consult the online WIL.HLP reference.
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.      37
  2071.