IVsExpansionClient Interface

Allows a VSPackage to participate in the code snippet insertion process.

Namespace:  Microsoft.VisualStudio.TextManager.Interop
Assembly:  Microsoft.VisualStudio.TextManager.Interop.8.0 (in Microsoft.VisualStudio.TextManager.Interop.8.0.dll)

Syntax

'Declaration
<GuidAttribute("9DD0F39A-9502-4068-93B7-B6ADAB33ECD8")> _
<InterfaceTypeAttribute()> _
Public Interface IVsExpansionClient

[GuidAttribute("9DD0F39A-9502-4068-93B7-B6ADAB33ECD8")]
[InterfaceTypeAttribute()]
public interface IVsExpansionClient

[GuidAttribute(L"9DD0F39A-9502-4068-93B7-B6ADAB33ECD8")]
[InterfaceTypeAttribute()]
public interface class IVsExpansionClient

[<GuidAttribute("9DD0F39A-9502-4068-93B7-B6ADAB33ECD8")>]
[<InterfaceTypeAttribute()>]
type IVsExpansionClient =  interface end

public interface IVsExpansionClient

The IVsExpansionClient type exposes the following members.

Methods

	Name	Description
	EndExpansion	Called to signal the end of the code snippet insertion and editing phase.
	FormatSpan	Called to format the specified span in the specified text buffer.
	GetExpansionFunction	Called to obtain an expansion function for the specified code snippet.
	IsValidKind	Called to verify that the specified location can accept the specified kind of snippet.
	IsValidType	Called to verify that the specified location can accept the specified types of code snippets.
	OnAfterInsertion	Called after the code snippet has been inserted and formatted.
	OnBeforeInsertion	Called before the code snippet has been inserted.
	OnItemChosen	Called when a code snippet name has been selected from an IntelliSense menu.
	PositionCaretForEditing	Called to position the edit caret in the specified place in a code snippet after it has been inserted and formatted.

Top

Remarks

This interface is used by clients of the code snippet manager to:

• Receive before and after notifications during the insertion process.

• Format the code snippet after it is inserted.

• Verify that the snippet can be inserted at a given location.

• Initiate a code snippet insertion in response to an IntelliSense menu selection of a code snippet.

• Position the edit caret after a code snippet has been inserted.

Notes to Implementers

This interface is implemented by a VSPackage that supports insertion of code snippets. If you support the use of the InvokeInsertionUI method in the IVsExpansionManager interface (typically through a custom menu action that your VSPackage installs), then you must implement the IVsExpansionClient interface and the OnItemChosen method. Otherwise, you do not need to implement the IVsExpansionClient interface unless you need to verify the placement of code snippets or you support automatic formatting of source code.

Notes to Callers

This interface is instantiated and passed to the InvokeInsertionUI method in the IVsExpansionManager interface. This interface is also instantiated and passed to the methods in the IVsExpansion interface.

See Also

Reference

Microsoft.VisualStudio.TextManager.Interop Namespace