                ********************************************
                         KiXforms 2.2.0 (Build 37)

                      (c) Copyright 2002 - Freeware
                ********************************************


	Thank you for using KiXforms ! This README file contains the
	latest information about KiXforms. For further documentation
	and usage, please refer to the online help, tutorials and sample
	scripts located at:

	http://www.kixforms.org

	For general discussions, questions, suggestions or to report
	bugs, please visit the KiXtart Bulletin Board (COM Forum) at:

	http://www.kixtart.org/cgi-bin/ultimatebb.cgi


				  INSTALL
				  UPGRADE
				============

	1) Unzip the contents of this archive into a separate directory

	2) Start a DOS prompt, go to that directory and enter the
	   following command:

	   c:\> regsvr32 kixforms.dll
	
	3) To un-install KiXforms, enter the following command:

	   c:\> regsvr32 -u kixforms.dll

	4) To upgrade to a newer version, simple replace the newer DLL
	   over the older DLL and re-register with regsvr32.


				 KNOWN ISSUES
				 ============

	- ComboBox can't generate OnKeyDown events (current release).


				RELEASE NOTES
				=============

2.2.0 Build 37

	o ToolButton - A ToolButton supports both text (caption) and graphics on a
	  single button. ToolButton supports almost all of the same properties and
	  methods supported by the existing Button control and in addition some
	  exciting new features like flatstyle, popup and colorized hot-tracking.

	o ImageList - An ImageList manages a collection of Images (Bitmaps & Icons)
	  that are all the same size. Provides properties to set the image size and
	  methods to add icons and bitmaps into the collection. The AddStrip adds
	  support for including ToolBar style bitmaps into ones script.

	o Added a library of 16x16 color icons into the KIXFORMS.DLL. The icons are
	  referenced by specifying their index number to any control that supports
	  the ICON property. For example, to access the first icon in the library:

	  $ToolButton.Icon = 0

	o Enhanced BeginUpdate and EndUpdate. Changed the internal behavior of these
	  methods. It is now advisable to call BeginUpdate/EndUpdate directly on the
	  ListView object, instead of indirectly by freezing the parent form.

	o Added Copy(), Cut(), Paste(), Undo() methods to TextBox control.

	  Copy() : Copies the current selection in the text box to the Clipboard.
	  Cut() : Moves the current selection in the text box to the Clipboard.
	  Paste() : Replaces the current selection in the text box with the Clipboard contents.
	  Undo() : Undoes the last edit operation in the text box.

	o Added DropDownWidth to ComboBox. The DropDownWidth property gets or sets
	  the size of the drop-down portion of a combo box control. Note: The width
	  of the drop-down cannot be smaller than the ComboBox width.

	o Added EnsureVisible method to ListView control. EnsureVisible ensures that
	  the specified item is visible within the control, scrolling the contents of
	  the control if necessary. Syntax is:

	  $ListView.EnsureVisible(Index)

	  Index - The zero-based index of the item to scroll into view.

	o Added ThreeState property to CheckBox control. This enables the third
	  'undetermined' state (a tick on a grey background) to be displayed. When
	  ThreeState is set to TRUE, the valid CheckBox values are:
	  
	  0 = Unchecked
	  1 = Checked
	  2 = Undefined

	o Added optional Color parameter to Line method. For example:

	  $Form.Line(10,10,100,10,"White")

	o Changed default size of Form to 300x300 (dotnet).

	o Corrected TabStop property for ProgressBar. Changed default to FALSE.

	o Removed extraneous Form refresh after setting Resizable property.

	o Fixed issue with selecting the first string in a ComboBox (when a similar
	  string existed further down in the list).

	o Fixed refresh issue with setting backcolor for some controls.

	o Fixed major memory leak in bitmapped background of Form and PictureBox.

	o Fixed getting FontUnderline property

	o Fixed problem with creating a CheckBox without any params, example:
	    $CheckBox = $Form.CheckBox()
	  Would set the size of the CheckBox to 0,0 by default.


2.1.2 Build 36

	o Added support for extracting icons from EXEs. Syntax is to provide the
	  fullpath of an executable followed by the index # of the icon to extract,
	  example:

	  $Button.Icon = "c:\folder\program.exe;n"

	  This release will return the 32x32 (lge) version of the icon. Cannot return
	  a small 16x16 at this time.

	o Added support for deleting columns from the ListView object.
	  Syntax is as follows:

	  $ListView.Columns(#).Remove
	  $ListView.Columns.Remove(#)

	o Fixed SpinButton long duration click behavior. Control will
	  no longer stall when holding down the arrow buttons. Corrected
	  automatic SpinButton acceleration. New behavior is that as
	  the arrows buttons are depressed for various durations, the
	  increment (or decrement) will accelerate by more than one.
	  Refer to following table for acceleration levels:

	  Seconds    Value +/-
	  -------    ---------
	    0-2		 1
	    2-5 	 5
	    5+		20

	o Fixed changing of BorderStyle=0 for all controls. Prior
	  behavior did not account for expansion/contraction of
	  client area by adding/removing border. Effect was mostly
	  evident for Image control where bitmap was stretched
	  incorrectly. New behavior accounts for this.

2.1.1 Build 35

	o Added HeaderStyle property to ListView object (write-only).
	  Settings are as follows:

	  0 = Header hidden
	  1 = Header visible - not clickable
	  2 = Header visible - clickable

	o Fixed FILTER problem with FileOpenDialog and FileSaveDialog

	o Added INSERT method to ListViewItemCollection. Usage is as
	  follows:

	  $Item = $ListView.Items.Insert(index,text)

	  This creates a new item and inserts it into the collection at the
	  specified index. To add an item to the beginning of this list, specify
	  this:

	  $Item = $ListView.Items.Insert(0,"John Doe")

	  To insert an item to the end of list, specify this:

	  $Item = $ListView.Items.Insert($ListView.Items.Count,"John Doe")

	  The previous example performs the same action as Items.Add()

	o Fixed ListView FullRowSelect to respond to boolean TRUE/FALSE

	o Added SuperLocked setting to TextBox LOCKED property. The sew settings
	  for locked are as follows:

	  0 = Unlocked
	  1 = Locked (user can copy/paste/navigate only)
	  2 = SuperLocked (user can navigate only)

	o Changed INPUTBOX to initially set focus to the text box on startup and to
	  pre-select (highlight) the default string.

	o Fixed RadioButtons on forms that have subforms with child controls.

	o Fixed various memory leaks when returning objects from ListView.

	o Changed (fixed) the handling of the DEFAULT button and TEXTBOXES on the
	  same form.

	o Much improved sorting of ListView control via ColumnHeader click

	o Enabled property for all objects now supports TRUE/FALSE strings.

2.1.0 Build 34

	o ProgressBar control supports the following new properties:

	  STYLE = n

	  0 = Blocked (Chunky) style bar
	  1 = Solid (Smooth) style bar

	  ORIENTATION = n

	  0 = Horizontal progress bar
	  1 = Vertical progress bar

	o Added COMBOBOX STYLE property. ComboBoxes can now be set to one of
	  the following three styles:

	  STYLE = n

	  0 = DropDown

	  The text portion is editable. The user must click the arrow button
	  to display the list portion.

	  1 = DropDownList

	  The user cannot directly edit the text portion. The user must click
	  the arrow button to display the list portion.

	  2 = Simple

	  The text portion is editable. The list portion is always visible.


	o Added COLORNAME support for BackColor and ForeColor properties. For
	  example, to set the background color of a Form to blue, one can
	  now say this:

	  BACKCOLOR = "SkyBlue"
	  FORECOLOR = "IndianRed"

	  Most standard color names are supported. There are tons of colorname
	  charts on the web for example:

		http://www.keller.com/rgb.html

	o Added LISTVIEW control. See white paper on usage.

	o Enabled rapid clicking of CommandButtons. Buttons no longer
          support the OnDoubleClick event.

	o Fixed setting MousePointer back to 0 & 1 (Default/Arrow).

	o Fixed OnKeyDown property to work with all versions
	  of KiXtart.

	o Added ClientSize property (write-only). Sets the inner width
	  and height of an object. Useful for correctly scaling the
	  inside dimensions of forms and frames, example:

		$Form.ClientSize = 640,480

	o Added Bounds property (write-only) to all objects. An array
	  that sets the bounding location and dimension (Left, Top,
	  Width, and Height) of an object , example:

	  $Form.Bounds = 10,10,200,300


2.0.5 Build 33

	o Improved task switching behavior. Form now restores
	  keyboard focus back to previous control when task
	  switching between forms and other windows applications.
	  Next step - enable same feature when switching
	  within forms itself.

	o Fixed some behaviors of the HyperLink object.

	  - Can now retrieve the Value (URL) property.

	  - Corrected constructor to properly display Caption.

	  - ToolTips are now DISABLED by default. The following
	    example sets the ToolTip to be the same as the VALUE
	    (URL) property text:

	    $HyperLink.ToolTip = $HyperLink.Value

	o Added FontTransparent property to Form object. By default,
	  FontTransparent is set to TRUE. To print text on a form
	  and have graphics underneath totally erased, set
	  FontTransparent to FALSE.

	  * Note when using proportional font "spaces" to overwrite text
	  on a form. The space character in a proportional-font can
	  is very narrow (thin), and may require many more of them to
	  fully overwrite the entire text area.

	o Added the OnActivate and OnDeactive events to FORM
	  object. Occurs when a form is activated or deactivated
	  by the user (task switching), or through code (popups).
	  The very first (initial) OnActivate event for the main
	  form object cannot be captured in the current release.

	o Added enhanced auto-refresh for Left,Top,Width,Height
	  properties.

	o Added OnKeyDown event. Occurs when a user presses
	  a key while the object has the focus.

	o Added KeyCode property. Gets the key code associated
	  with the key that caused the OnKeyDown Event.

	o Fixed Sorted and List property memory leak.

	o Fixed automatic vertical and horizontal scroll bars
	  for ListBox and ComboBox object.

2.0.4 Build 32

	o Added SORTED property for LISTBOX and COMBOBOX.
	  Valid values are:

	  SORTED = 0/1 TRUE/FALSE

	o Added TABGROUP property for RADIOBUTTONS. TabGroup designates
	  the first RadioButton (OptionButton) in a group of mutually
	  exclusive radio buttons. Format is:

	  TABGROUP = 1/0 TRUE/FALSE

	o Fixed REFRESH property for ALL objects.

	o Fixed LISTINDEX problem with COMBOBOX.

	o Fixed TOPMOST property - no longer disables child forms.

	o Added SCROLLBARS property to TEXTBOX object.

	  Valid values are:

	  0 = No ScrollBars
	  1 = Horizontal ScrollBar
	  2 = Vertical ScrollBar
	  3 = Horizontal and Vertical ScrollBars

	o Fixed HYPERLINK CAPTION & TEXT property refresh problem.

	o Fixed TABBING on child forms.

	o Fixed PICTUREBOX BORDSERSTYLE property - bad window styles.

2.0.3 Build 31

	o Add auto horizontal and vertical scrolling for TEXTBOX object.

2.0.2 Build 30

	o Added the LOCKED property to the TEXTBOX object.

	o Renamed the SPINBUTTON control to SPINNER control. Sorry
	  but best I do this now as opposed to later.

	o Added more features to the BORDERSTYLE property for ALL objects.

	  2 = Sunken
	  3 = Raised
	  4 = Framed

2.0.1 Build 29

	o Changed the name of the TRACKBAR object to
	  SLIDER object.

	o Added BACKCOLOR property to PROGRESSBAR object.

	o Added FORECOLOR property to PROGRESSBAR object.

	o Changed LISTBOX and COMBOBOX constructors to create
	  lists that are NOT SORTED by default. Will be adding
	  the SORTED property first in the next release.

	o Changed (switched) the ORIENTATION property to the following:

	  0 = Horizontal
	  1 = Vertical
	
2.0.0 Build 28

	o Initial Release of 2.0






