Summary:

• 32-bit ActiveX control (OCX)
  
• Digitally signed
  
• Marked "safe for scripting" and "safe for initialization"
• Run-time memory requirements: Approx. 1 Mb.

Properties, methods, and events

ActiveX Speller's rich set of properties, methods and events give it the flexibility to support virtually all spell-check requirements.

Properties

All of ActiveX Speller's properties have reasonable defaults so you need to change or set only a small number of properties to suit your application's requirements.

---

AutoCorrect
ActiveX Speller can automatically replace one word with another (e.g., replace a frequently misspelled word with its correction, or replace an abbreviation with its expansion). This property turns automatic correction on or off.

CaseSensitive
Controls whether ActiveX Speller checks spelling with regard to differences in letter case (e.g., treating america and America as two separate words) or by ignoring differences in letter case. (e.g., treating america and America as the same word). Keeping this property enabled improves performance (because Spellex's dictionaries are optimized for case-sensitive access) and ensures that capitalization errors are detected. You might disable this property when checking text entered in all-caps, for example.

CanUndo
This property is set to True when the user has made a change to the checked text which can be undone. This property is useful for enabling an "Undo" button in a dialog box, for example.

CatchDoubledWords
ActiveX Speller can automatically detect the same word appearing twice in a row (e.g., Minutes of the the meeting were filed yesterday.) This property controls whether doubled words are reported to the user or your application (via the DoubledWord event).

CatchMixedCaseWords
ActiveX Speller can automatically detect words which have an unusual combination of upper- and lower-case letters (e.g., TUesday). This property controls whether mixed-case words are reported to the user or your application (via the MixedCaseWord event).

CatchWordsWithDigits
ActiveX Speller can automatically detect words which contain embedded digits, which might result from accidentally omitting a space (e.g., Monday14 August). This property controls whether words with embedded digits are reported to the user or your application (via the WordWithDigits event).

CurrentWord
Contains the current word in the text being checked. Your application can use this property to iterate through all words in the text, or to change the current word.

DialogLeft
This property sets the x coordinate of the built-in spell check dialog box.

DialogTop
This property sets the y coordinate of the built-in spell check dialog box.

IgnoreAllCapsWords
Controls whether ActiveX Speller automatically skips (ignores) words containing just capital letters. If the text contains many abbreviations or acronyms, setting this property prevents them from being reported as spelling errors.

IgnoreCapitalizedWords
Controls whether ActiveX Speller automatically skips (ignores) words starting with a capital letter. If the text contains many proper names, setting this property prevents them from being reported as spelling errors.

IgnoreDomainNames
Controls whether ActiveX Speller automatically skips (ignores) words which appear to be Internet domain names.

IgnoreHTMLMarkups
Controls whether ActiveX Speller skips (ignores) text in HTML markups. When this property is set to True, ActiveX Speller can be used to spell-check the visible portion of HTML.

IgnoreMixedCaseWords
Controls whether ActiveX Speller automatically skips (ignores) words which contain a mixture of upper- and lower-case letters. If the text contains variable names, technical jargon, etc. (e.g., YearToDate, FmtString), setting this property prevents them from being reported as spelling errors.

IgnoreNonAlphaWords
Controls whether ActiveX Speller automatically skips (ignores) words which contain no alphabetic letters. When checking general text, enabling this property will prevent non-alphabetic strings like phone numbers and ZIP codes from being reported as spelling errors. ActiveX Speller is flexible enough that it can be used for purposes such as validating part numbers, in which case this property would be disabled.

IgnoreWordsWithDigits
Controls whether ActiveX Speller automatically skips (ignores) words which contain embedded digits. When checking general text, enabling this property will prevent strings like product codes from being reported as spelling errors. ActiveX Speller is flexible enough that it can be used for purposes such as validating product codes and part numbers, in which case this property would be disabled.

MainDictionary
Used to access the set of main dictionary files. Spellex's main dictionaries are usually implemented as two files, and you may supplement them with application-specific terms. This indexed property is used to access the name of each individual main dictionary file.

MainDictionaryCount
Contains the number of main dictionary files currently open. This property is useful for limiting the index used in the MainDictionary property.

MainDictionaryFiles
Contains the set of main dictionary files, listed as a comma-delimited string. Setting this property closes the current set of main dictionary files and opens a new set.

MaxSuggestions
Specifies the maximum number of suggestions offered by the Suggest method. The Suggest method locates the best MaxSuggestions suggestions.

MinSuggestionDepth
Contains the initial search depth used by the Suggest method. See Looking up Suggestions for a discussion of search depths. Setting this property to a low value makes the Suggest method run faster, but also decreases the probability that the correct replacement word will be found. Setting this property to a high value increases both the search time and the probability of success.

MinSuggestionScore
The Suggest method eliminates any suggested word whose score falls below this property's value. This property is useful for limiting the set of suggestions to those which are very similar to the misspelled word.

MisspelledWord
Contains the last misspelled word detected by ActiveX Speller.

MisspelledWordCount
Contains the number of misspelled words detected so far in the text being checked.

PhoneticSuggestions
When this property is enabled, the Suggest method locates suggested replacements for misspelled words using phonetic (sounds like) matching. Phonetic matching is best used with words which are badly misspelled, as can happen when checking text entered by children or people learning a second language. (Currently, phonetic matching works only with English pronunciation rules.)

ReplacementWord
Contains the word which will be substituted for the misspelled word when the ReplaceWord method is called.

ShowContext
When this property is enabled, the built-in spelling checker dialog box will display the contents of the Text property so the user can see misspelled words in their context. If False, the context area will not be shown. This property is useful when checking words contained in text strings.

ShowDialog
When this property is enabled, the built-in spelling-checker dialog box will be presented to the user when the Start method is invoked. The dialog box will appear only if a misspelled word is encountered. If the ShowContext property is True, the dialog will contain a context area which displays the contents of the Text property. If the ShowDialog property is False, the built-in spelling checker dialog box will not be displayed, which allows your application to define its own user interface or to check spelling without a user interface.

SplitContractedWords
When this property is enabled, apostrophes will, if necessary, be treated as word separators, and each sub-word checked individually. This property is intended for use with Spellex's French and Italian dictionaries.

SplitHyphenatedWords
When this property is enabled, hyphens ("-") will, if necessary, be treated as word separators, and each sub-word checked individually.

SplitWords
When this property is enabled, words will, if necessary, be treated as a series of concatenated sub-words, and each sub-word checked individually. This property is intended for use with Spellex's German and Finnish dictionaries.

StripPossessives
When this property is enabled, possessives of the form 's and s' will be removed from words before checking their spelling.

Suggestion
This property is used to index the set of suggestions produced by the Suggest method.

SuggestionCount
Contains the number of suggestions produced by the Suggest method. This property is useful for limiting the index passed to the Suggestion property.

SuggestionDepth
Contains the depth used to locate suggested replacements for misspelled words. See Looking up suggestions for a discussion of suggestion depth. The SuggestionDepth property is automatically set to the value of the MinSuggestionDepth property the first time the Suggest method is called to look up suggestions for a specific word.

SuggestionDepthIncrement
Each time the Suggest method is called, the SuggestionDepth property is increased by the value of this property. See Locating Suggestions for a discussion of suggestion depth.

SuggestionScoreRange
Contains the range of top scores used to filter suggestions. Only suggestions whose score falls within SuggestionScoreRange of the top-scoring suggestion will be offered. This property is useful for limiting the set of suggested words to the most probable set.

SuggestSplitWords
When this property is enabled, the Suggest method will attempt to split the misspelled word into two, and will offer the split words as suggestions if both are valid words. This is useful for correcting words incorrectly joined by a missing space. (e.g., If this property is enabled, the Suggest method would suggest the dog as a replacement for thedog.)

Text
Contains the text to be spell checked. The Text property can contain any number of words (even just one), limited only by memory. The Text property is automatically set to the contents of a text box when the TextControlHWnd property is set.

TextControlHWnd
Contains the hWnd property (i.e., the window handle) of a text box or other text-containing control to be checked. When this property is set, the Text property is set to the text contained by the specified control. If the control is a standard text box or rich-text box, misspelled words will be highlighted and replacements updated automatically. Your application can spell check the contents of a text box by just setting this property and calling the Start method.

TextLength
Contains the current number of characters in the Text property.

TypographicalSuggestions
When this property is enabled, the Suggest method locates suggested replacements for misspelled words using typographical (looks like) matching. Typographical matching is best used with words which contain one or two spelling errors. See the PhoneticSuggestions property for more information.

UndoNewText
Contains the new text inserted in the last undone change. This property is useful for implementing an Undo feature in your own user interface; the built-in spell check dialog box contains an Undo button that automatically performs the processing needed to undo a change.

UndoOffset
Contains the offset of the last undone change in characters from the start of the Text property. This property is useful for implementing an Undo feature in your own user interface; the built-in spell check dialog box contains an Undo button that automatically performs the processing needed to undo a change.

UndoOldText
Contains the original text which was changed in the last undone operation. This property is useful for implementing an Undo feature in your own user interface; the built-in spell check dialog box contains an Undo button that automatically performs the processing needed to undo a change.

UserDictionary
Used to access the set of user dictionary files. This indexed property is used to access the name of each individual user dictionary file.

UserDictionaryCount
Contains the number of user dictionary files currently open. This property is useful for limiting the index used in the UserDictionary property.

UserDictionaryFiles
Contains the set of user dictionary files, listed as a comma-delimited string. Setting this property closes the current set of user dictionary files and opens a new set.

UserDictionaryOtherWord
Contains the alternate word associated with a word in a user dictionary. See About user dictionaries and actions for more information on ActiveX Speller's user dictionaries.

UserDictionaryWord
Obtains a word at a given index from a user dictionary. The words in a user dictionary can be enumerated by indexing this property.

UserDictionaryWordAction
Contains the action associated with a word in a user dictionary. See About user dictionaries and actions for more information on ActiveX Speller's user dictionaries and the action codes which can be associated with words.

UserDictionaryWordCount
Contains a count of the words in a user dictionary. This property is useful for limiting the index passed to the UserDictionaryWord property.

Version
Contains ActiveX Speller's version id.

WordCount
Contains the number of words currently in the Text property.

WordOffset
Contains the offset of the start of the current word from the start of the Text property.

WordsReplacedCount
Contains the number of words changed so far in the Text property.

Methods >>