The interface of completion proposals generated by content assist processors. A completion proposal contains information used to present the proposed completion to the user, to insert the completion should the user select it, and to present context information for the chosen completion once it has been inserted.
In order to provide backward compatibility for clients of ICompletionProposal, extension interfaces are used to provide a means of evolution. The following extension interfaces exist:
- {@link org.eclipse.jface.text.contentassist.ICompletionProposalExtension} since version 2.0 introducingthe following functions:
- handling of trigger characters other than ENTER
- completion proposal validation for a given offset
- context information can be freely positioned
- {@link org.eclipse.jface.text.contentassist.ICompletionProposalExtension2} since version 2.1 introducingthe following functions:
- handling of trigger characters with modifiers
- visual indication for selection of a proposal
- {@link org.eclipse.jface.text.contentassist.ICompletionProposalExtension3} since version 3.0 introducingthe following functions:
- provision of a custom information control creator
- provide a custom completion text and offset for prefix completion
- {@link org.eclipse.jface.text.contentassist.ICompletionProposalExtension4} since version 3.1 introducingthe following functions:
- specify whether a proposal is automatically insertable
- {@link org.eclipse.jface.text.contentassist.ICompletionProposalExtension5} since version 3.2 introducingthe following function:
- Allow background computation of the additional info
- {@link org.eclipse.jface.text.contentassist.ICompletionProposalExtension6} since version 3.4 introducingthe following function:
- Allow styled ranges in the display string.
This interface can be implemented by clients. By default, clients use {@link org.eclipse.jface.text.contentassist.CompletionProposal} as thestandard implementer of this interface.
@see IContentAssistProcessor