Declarations.OnAutoComplete Method
Called after the declaration has been committed to the source file. When implemented in a derived class, it provides a completion character which may itself be a trigger for another round of IntelliSense.
Namespace: Microsoft.VisualStudio.Package
Assemblies: Microsoft.VisualStudio.Package.LanguageService (in Microsoft.VisualStudio.Package.LanguageService.dll)
Microsoft.VisualStudio.Package.LanguageService.9.0 (in Microsoft.VisualStudio.Package.LanguageService.9.0.dll)
Microsoft.VisualStudio.Package.LanguageService.10.0 (in Microsoft.VisualStudio.Package.LanguageService.10.0.dll)
Syntax
'Declaration
Public Overridable Function OnAutoComplete ( _
textView As IVsTextView, _
committedText As String, _
commitCharacter As Char, _
index As Integer _
) As Char
'Usage
Dim instance As Declarations
Dim textView As IVsTextView
Dim committedText As String
Dim commitCharacter As Char
Dim index As Integer
Dim returnValue As Char
returnValue = instance.OnAutoComplete(textView, _
committedText, commitCharacter, _
index)
public virtual char OnAutoComplete(
IVsTextView textView,
string committedText,
char commitCharacter,
int index
)
public:
virtual wchar_t OnAutoComplete(
IVsTextView^ textView,
String^ committedText,
wchar_t commitCharacter,
int index
)
abstract OnAutoComplete :
textView:IVsTextView *
committedText:string *
commitCharacter:char *
index:int -> char
override OnAutoComplete :
textView:IVsTextView *
committedText:string *
commitCharacter:char *
index:int -> char
public function OnAutoComplete(
textView : IVsTextView,
committedText : String,
commitCharacter : char,
index : int
) : char
Parameters
- textView
Type: Microsoft.VisualStudio.TextManager.Interop.IVsTextView
[in] An IVsTextView object representing the view that displays the source file.
- committedText
Type: System.String
[in] A string containing the text that was inserted as part of the completion process.
- commitCharacter
Type: System.Char
[in] The character that was used to commit the text to the source file.
- index
Type: System.Int32
[in] The index of the item that was committed to the source file.
Return Value
Type: System.Char
Returns a character to be inserted after the committed text. If nothing is to be inserted, returns 0.
Remarks
After text has been committed to the source file, this method is called to complete the characters already committed. For example, in the XML editor, if the user selects a start tag ("<foo"), this method is used to insert the end tag automatically ("></foo>"). The framework makes sure this method is called after Visual Studio has actually inserted the result from OnCommit, in this case "<foo".
This method can also be used to start another commitment based on the character that is returned. For example, if a method name is committed to the source file and the OnAutoComplete method returns an open parenthesis ("("), the "(" could then trigger the IntelliSense method tip operation.
The base method does nothing and returns 0.
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.