fvInitialCap - JavaScript Vision

fvInitialCap( )
See also: fsInitialCap

Converts a fields alphabetic characters to a proper-name.

Syntax

JSV_fvInitialCap(expO [, PROPERNAMES, RESETCASE])

Prototype

n/a

Returns

n/a

Parameters

The fvInitialCap function uses the following arguments.

Argument	Description
expO	The object.
PROPERNAMES	Optional. Handles the capitalization of two surname types (i.e., last names): those names that contain a single quote (e.g., O'Malley) and those names that start with 'Mc' (e.g., McCoy).
RESETCASE	Optional. Converts the entire string to lowercase before capitalizing each word. Useful for those instances where the string may be passed in ALL CAPITAL LETTERS. See Argument Placement below.

Remarks

Argument Placement

The arguments RESETCASE and PROPERNAMES can appear in any order with the string that is to have its first character capitalized.

For example,
fvInitialCap(expS, RESETCASE, PROPERNAMES),
fvInitialCap(RESETCASE, PROPERNAMES, expS),
fvInitialCap(RESETCASE, expS, PROPERNAMES)
and
fvInitialCap(expS, RESETCASE)
are valid calls to the fvInitialCap function.

Dependencies

JSV_fsInitialCap

Example

The following lines of code


<FORM NAME="InitCapForm">
<B>Name:</B>
<INPUT TYPE="Text" NAME="MyValue" VALUE="mccoy" SIZE="16" MAXLENGTH="16" onBlur="JSV_fvInitialCap(this, PROPERNAMES);">
<INPUT TYPE="Reset">
</FORM>

produce

Tab out of the Value field.