CURSOR SETTINGS

There are several entries in a jcf file that define how
JFW identifies a cursor.  The entries are listed below as
they appear in DEFAULT.JCF.

The following entries are contained in the [OPTIONS] section
of DEFAULT.JCF.

; how many cursor blinks are used to locate the caret
CaretDetect=1

; The number of milliseconds before JFW will give up looking
; for the caret 
CaretDetectTimeOut=250

; how fast the caret blinks, milliseconds on/off
CaretBlinkRate=53

These values are particularly important.  They must
coordinated or else one option can render another option
impossible.  For example, setting CaretDetect to 2 means
that JFW must see the cursor drawn two times in order to
assert that that it has indeed found the cursor.  If the
CaretBlinkRate has a high value so that the cursor is
blinking slowly, it is possible that CaretDetectTimeOut may
cause the search to expire before the Cursor is able to
blink the required number of times.

Some times it is better to set the CursorDetect value to 1.
This is useful in applications that do not have a blinking
cursor.  The CaretDetectTimeOut value can also be increased
(to 500 for example) to give JFW more time to locate the
cursor.  This may slow JFW's performance however.
CaretBlinkRate is already set to the fastest blink rate by
default.  It is suggested that you do not change this value.

The following entries are contained in the [OSM] section of
DEFAULT.JCF.  The entries prefixed with "Vert" are the
Vertical caret settings.  These entries define the
specifications of a vertical (up-down) caret. The X values
represent the width while the Y values represent the
Height.  The entries prefixed by "Horiz" represent the
specifications for a Horizontal (left-right) caret.  When
deciding how to set these values, one can use mouse movement
to travel the height and width of the caret.  Mouse
movement moves three pixels per keystroke by default so it
is a good means of finding the height and width of an
object in pixels.  The unit of measure for the caret
settings is the pixel.  Most frequently, these values should
be changed when using an exceptionally large font.
Winword.jcf contains a good example of this adaptation.

; minimum height of a line that can be treated as a vertical
; caret
VertCaretMinY=6

; maximum height  of a line  that can be treated as a
; vertical caret
VertCaretMaxY=29

; minimum width  of a line  that can be treated as a
; vertical caret
VertCaretMinX=1

; maximum width  of a line  that can be treated as a
; vertical caret
VertCaretMaxX=3

; minimum height  of a line  that can be treated as a
; horizontal caret
HorizCaretMinY=1

; maximum height  of a line  that can be treated as a
; horizontal caret
HorizCaretMaxY=4

; minimum width  of a line  that can be treated as a
; horizontal caret
HorizCaretMinX=4

; maximum width  of a line  that can be treated as a
; horizontal caret
HorizCaretMaxX=14

Some applications use a "block" cursor.  This requires some
changes in these settings.  If a cursor is block in shape,
then the X values should match the Y values.  For example,
the following settings may be applicable.

; minimum height of a line that can be treated as a vertical
; caret
VertCaretMinY=6

; maximum height  of a line  that can be treated as a
; vertical caret
VertCaretMaxY=29

; minimum width  of a line  that can be treated as a
; vertical caret
VertCaretMinX=6

; maximum width  of a line  that can be treated as a
; vertical caret
VertCaretMaxX=29

In most cases, these default settings are adequate.  It is
strongly recommended that, if you choose to adjust these
values, you create a jcf file for the specific application.
Examples of such files can be found in JFW\SETTINGS\ENU.
For further assistance, contact our technical support at
800-336-5658.
