All Manuals > CAPI User Guide > 11 Prompting for Input > 11.6 In-place completion > 11.6.1 In-place completion user interface

NextPrevUpTopContentsIndex Performing a Completion

In a text-input-pane , performing a completion means replacing part of the text in the pane by the selected completion. In a file-completion, only the last part of the text (from the last directory separator) is replaced.

If a text-input-pane was made with complete-do-action true, once the completion was performed, if it is not file-completion and the completion is a directory, the callback of the pane is invoked.

In an editor-pane , while the in-place window is displayed, the editor highlights the part of the text that will be replaced. In non-file-completion it is the beginning of the "symbol", as seen by the editor, and the end of the "symbol". In a file-completion it is the part of the filename after the last directory separator.

Performing the completion in an editor-pane means replacing the highlighted text by the selected completion. The replacement is done as a single separate operation (for example Undo will undo the replacement separately from any previous changes).

CAPI User Guide (Macintosh version) - 30 Aug 2011