IVsExpansionManager.InvokeInsertionUI Method

Shows an IntelliSense list of code snippets that can be inserted into the source through the provided IVsExpansionClient object.

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

Syntax

'Déclaration
Function InvokeInsertionUI ( _
    pView As IVsTextView, _
    pClient As IVsExpansionClient, _
    guidLang As Guid, _
    bstrTypes As String(), _
    iCountTypes As Integer, _
    fIncludeNULLType As Integer, _
    bstrKinds As String(), _
    iCountKinds As Integer, _
    fIncludeNULLKind As Integer, _
    bstrPrefixText As String, _
    bstrCompletionChar As String _
) As Integer

int InvokeInsertionUI(
    IVsTextView pView,
    IVsExpansionClient pClient,
    Guid guidLang,
    string[] bstrTypes,
    int iCountTypes,
    int fIncludeNULLType,
    string[] bstrKinds,
    int iCountKinds,
    int fIncludeNULLKind,
    string bstrPrefixText,
    string bstrCompletionChar
)

int InvokeInsertionUI(
    [InAttribute] IVsTextView^ pView, 
    [InAttribute] IVsExpansionClient^ pClient, 
    [InAttribute] Guid guidLang, 
    [InAttribute] array<String^>^ bstrTypes, 
    [InAttribute] int iCountTypes, 
    [InAttribute] int fIncludeNULLType, 
    [InAttribute] array<String^>^ bstrKinds, 
    [InAttribute] int iCountKinds, 
    [InAttribute] int fIncludeNULLKind, 
    [InAttribute] String^ bstrPrefixText, 
    [InAttribute] String^ bstrCompletionChar
)

abstract InvokeInsertionUI : 
        pView:IVsTextView * 
        pClient:IVsExpansionClient * 
        guidLang:Guid * 
        bstrTypes:string[] * 
        iCountTypes:int * 
        fIncludeNULLType:int * 
        bstrKinds:string[] * 
        iCountKinds:int * 
        fIncludeNULLKind:int * 
        bstrPrefixText:string * 
        bstrCompletionChar:string -> int 

function InvokeInsertionUI(
    pView : IVsTextView, 
    pClient : IVsExpansionClient, 
    guidLang : Guid, 
    bstrTypes : String[], 
    iCountTypes : int, 
    fIncludeNULLType : int, 
    bstrKinds : String[], 
    iCountKinds : int, 
    fIncludeNULLKind : int, 
    bstrPrefixText : String, 
    bstrCompletionChar : String
) : int

Parameters

• pView
  Type: Microsoft.VisualStudio.TextManager.Interop.IVsTextView
  [in] An IVsTextView object representing the view in which to present the list.

• pClient
  Type: Microsoft.VisualStudio.TextManager.Interop.IVsExpansionClient
  [in] An IVsExpansionClient object representing the expansion client that is used to complete the insertion of the code snippet.

• guidLang
  Type: System.Guid
  [in] The GUID of the coding language (typically, this is the language service GUID).

• bstrTypes
  Type: array<System.String[]
  [in] An array strings specifying snippet types to display. This can be a null value if iCountTypes is 0. See Remarks.

• iCountTypes
  Type: System.Int32
  [in] The number of types specified in the bstrTypes array. If this is 0, all types are displayed.

• fIncludeNULLType
  Type: System.Int32
  [in] Non-zero (TRUE) if to include code snippets with "empty" types in the bstrTypes list (this parameter is ignored if iCountTypes is 0).

• bstrKinds
  Type: array<System.String[]
  [in] An array of strings specifying the snippet kinds to display. This can be a null value if iCountKinds is 0. See Remarks.

• iCountKinds
  Type: System.Int32
  [in] The number of kinds specified in the bstrKinds array. If this is 0, all kinds are displayed.

• fIncludeNULLKind
  Type: System.Int32
  [in] Non-zero (TRUE) if to include code snippets with "empty" kinds in the bstrKinds list (this parameter is ignored if iCountKinds is 0).

• bstrPrefixText
  Type: System.String
  [in] A string containing the text to show in the prompt.

• bstrCompletionChar
  Type: System.String
  [in] A character that, when typed, inserts the currently selected snippet and closes the UI. If this is a null value or an empty string, typing the Enter key is the only way to insert a selected snippet.

Return Value

Type: System.Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From textmgr2.idl:

HRESULT IVsExpansionManager::InvokeInsertionUI(
   [in] IVsTextView *pView,
   [in]IVsExpansionClient *pClient,
   [in]GUID guidLang,
   [in, size_is(iCountTypes)] BSTR *bstrTypes,
   [in] long iCountTypes,
   [in] bool fIncludeNULLType,
   [in, size_is(iCountKinds)] BSTR *bstrKinds,
   [in] long iCountKinds,
   [in] bool fIncludeNULLKind,
   [in] BSTR bstrPrefixText,
   [in] BSTR bstrCompletionChar
);

The bstrTypes list contains strings that specify the types of snippets to display. These types can be "Expansion" or "SurroundsWith" (see SnippetType Element (IntelliSense Code Snippets) for details on snippet types). It is possible for a code snippet to not have a type associated with it, in which case such snippets are not displayed unless the fIncludeNULLType parameter is non-zero (TRUE) or the iCountTypes parameter is 0.

The bstrKinds list contains strings that specify the kinds of snippets to display, such as MethodBody, Page, and File. The snippet kind can control in what context the snippet is inserted. For example, a snippet kind of MethodBody should be inserted only in a method. See Code Element (IntelliSense Code Snippets) for a list of all snippet kinds that are supported. It is possible for a code snippet to not have a kind associated with it, in which case such snippets are not displayed unless the fIncludeNULLKind parameter is non-zero (TRUE) or the iCountKinds parameter is 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.

See Also

Reference

IVsExpansionManager Interface

Microsoft.VisualStudio.TextManager.Interop Namespace

Other Resources

SnippetType Element (IntelliSense Code Snippets)

Code Element (IntelliSense Code Snippets)