.TITLE: Advanced ALC_ sample and ShowKeyboard sample

Summary:

In the Microsoft Software Library, there is a sample called
AlcKey.  This is a Windows for Pens sample that demonstrates
how to use the ALC values (defined in Windows for Pens) to
set how an hedit (or bedit control) will filter it's input.

More Information:

ALC values can be set to define what values will be recognized
in a pen edit control (either hedit or bedit.)  For example, by
setting ALC_NUMERIC, only Numeric values will be recognized in
that particular control.  Using ALC values allows the developer
greater freedom to customize how his application will respond to
ink.  By defining a small subset of only the types of values 
wanted in an edit control, recognition of those values will 
increase.

The AlcKey sample has two edit controls, an hedit and a bedit.  By
selecting the ALC flags desired in the ALC dialog, the hedit control
is set to those values.  The bedit control is not altered in anyway
allowing the developer to see the difference between the settings
of the two controls.

Also the AlcKey sample also demonstrates the use of the ShowKeyboard
API, including the recommended way of interfacing to the Virtual 
keyboard via a "keyboard" button; which is OwnerDraw.  The developer
will notice that the Virtual Keyboard always stays on top, but never
has the focus.  The output of the keyboard is directed to the last
control that had the focus.  This sample also demonstrates one way of
insuring that only valid controls get the focus. You will also 
notice that the Virtual Keyboard in Windows for Pens version 1.0
is not affected by the filtering effects of the ALC values.  Only
recognized ink is affected, the keyboard does not involve inking,
so it bypasses this step.