NAME

       MatchEditor - StringEditor with string completion

SYNOPSIS

       #include <InterViews/compeditor.h>

DESCRIPTION

       CompletionEditor  is  a  StringEditor subclass with the added ability to complete the current contents of
       the edit buffer against a specified set of strings.  A CompletionEditor is often useful when a user  must
       specify  a  selection  from  a  large  set  of  well-known strings--the user need only type the first few
       characters of the string; he types the completion character to fill out the remainder.

       When the user types the completion character, CompletionEditor checks the current string against the list
       of possible completions.  If the current string is a prefix of one or more completion strings, characters
       are appended so that the edit string contains the longest common prefix; if the current string  does  not
       match  any  completion  string,  trailing  characters  are  removed until the string matches at least one
       completion.  In any case, if there is more than one possible completion  of  a  string,  CompletionEditor
       rings the workstation bell.

PUBLIC OPERATIONS

       CompletionEditor(ButtonState*, const char* sample, const char* done)
              Create  a new CompletionEditor object.  The ButtonState, sample string, and termination string are
              passed to the StringEditor constructor.

       void Completions(const char* completions[], int count, char complete)
              Specify the list of completion strings and the completion character.  The initial completion  list
              is  empty,  and  the completion character defaults to a space.  CompletionEditor does not copy the
              strings in the list.

SEE ALSO

       StringEditor(3I)

InterViews                                         13 Dec 1989                                   MatchEditor(3I)