
    WNDNUM v2.00
    Copyright (c) 1993,1994 Williston Consulting
    ALL RIGHTS RESERVED

    What's new in v2.00?
    --------------------

           Rewrote entire DLL to actually paint the non-client area of
            each child window.  This solves several painting bugs and
            eliminates a great deal of flashing.

           Fixed numbering problem with Codewright v3.x output window
            (support for Codewright v2.x has been dropped).

           Added WNSetCaptionAlignment function to allow the user to
            specify how child window title bar text should be aligned.

           Included support for Codewright/NT.


    What's new in v1.13?
    --------------------

			Fixed a bug that caused a nasty crash when closing a window
            with iconic windows present.


	What's new in v1.12?
	--------------------

			All known Windows and CodeWright termination bugs have been
			squashed; no more lockups when exiting Windows without
			first closing CodeWright!


	What's new in v1.11?
	--------------------

			A version of WNDNUM that can be used with CodeWright v2.0f is
			now supplied.


    What's new in v1.10?
    --------------------

           Alt-<n> switching capability will now function when an iconic
            window has the focus.

           WNUppercase function lets the user set whether the edit
            window captions will be rendered in uppercase.

           Title bar numbers remain in better sync when edit windows are
            opened and closed.

           CodeWright INI file section reading at startup.


    Overview
    --------

    When I started using Microsoft development tools (*many* years ago), I
    learned to depend on their Alt-<number> shortcut for switching windows.
    This is one of the few features CodeWright doesn't provide, and it has
    bothered me for some time.  That's how this little DLL was born.
    With an eye towards making everybody's life easier (while shirking
    responsibility for virtually anything), I'm	retaining intelluctual
    property rights to the source code while donating the binary to the
    freeware domain.  Feel free to pass it along to your friends, romans,
    countrymen, etc. as long as no fee beyond that which is reasonable for
    disk duplication and distribution is collected.


	Installation
	------------

	Installation is pretty simple; you merely have to make sure the DLL gets
	loaded by CodeWright.  The LibPreload API command will take care of this
	for	you.  Simply add the following line to your CWRIGHT.INI file:

		LibPreload=c:\cwright\wndnum.dll

	You must give it the correct path to the WNDNUM.DLL file, but, other
	than that, there's not much to go wrong.  If you're using v3.x of
	CodeWright, you can place this line in the [LibPreload] section of the
	CWRIGHT.INI file; otherwise, I would suggest putting it somewhere in the
	[Editor] section.


    Usage
    -----

    Using WNDNUM is also pretty simple -- you don't really have to do much.
    When WNDNUM is loaded, a number will appear to the left of the filename
    bracketed by '<' and '>' characters within each window's caption.  For
    example, if I'm editing C:\CWRIGHT\CWRIGHT.INI, its window caption will
    look something like "<1> c:\cwright\cwright.ini" -- the number will,
    of course, be the same as the number on the Window menu.  You may then
    switch to this window from any other window by simply pressing <Alt-1>.
    When switching to a minimized window, WNDNUM will restore the window to
    its normal size for your convenience (this is also done to avoid a
    problem with minimized windows in CodeWright).

    In order to let WNDNUM handle system windows and avoid adding lots
    of KmapAssign statements to your CWRIGHT.INI file, WNDNUM avoids
    remapping any of your key bindings.  Those of you who use Alt-<number>
    for some other purpose can have no fear:  any key-bindings that you
    already have will take precedence.  Additionally, if you should like
    to bind a keystroke to select a given window number, WNWinSelectNumber
    has been provided for your convenience.  Simply pass it a valid number
    and let it go; it will return the previously active window number.
    Note:  WNWinSelectNumber is not limited to the first nine windows.

    You may optionally force all edit window captions to uppercase (once
    again ala Visual C/C++) with the new WNUppercase function.  It takes
    a single integer parameter:  zero will cause normal lowercase rendering
    (this is the default), and anything else causes uppercase rendering.
    I would suggest setting this value in the [WndNum] section of your
    CodeWright INI file as shown in the example below.

        [WndNum]
        WNUppercase=1   ; turn uppercase rendering on

    The WNSetCaptionAlignment function allows the user to specify the title
    bar text alignment for editing windows within Codewright.  The function
    takes a single string argument.  The first character of the argument
    is checked against L, C, and R to set the alignment to left, centered,
    and right aligned respectively.  It's a "fluff" function, but I put so
    much work into handling non-client painting that I couldn't resist.


    Getting Help
    ------------

    For general help consult the owner's manual:  the Bible.  Jesus Christ
    has the power to change lives; my own life is testimony of this.
    Why not give Him a chance?  For help with this utility, however, you can
    reach me on the Premia BBS or on CompuServe (CIS ID:  70541,1335).
    Happy coding!


    John B. Williston
    10/27/94 1900


