IVsExpansionClient.OnItemChosen Method (String, String)

 

Called when a code snippet name has been selected from an IntelliSense menu.

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

int OnItemChosen(
	string pszTitle,
	string pszPath
)

Parameters

pszTitle
Type: System.String

[in] A string containing the full name of the code snippet.

pszPath
Type: System.String

[in] A string containing the full path to the snippet file.

Return Value

Type: System.Int32

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

From textmgr2.idl:

HRESULT IVsExpansionClient::OnItemChosen(
   [in] BSTR pszTitle,
   [in] BSTR pszPath
);

This method is called when the user selects a code snippet from a list of snippets, typically presented in an IntelliSense menu. The menu is shown as a result of a call to the InvokeInsertionUI method in the IVsExpansionManager interface.

A typical implementation of the OnItemChosen method is to call the InsertNamedExpansion method on the IVsExpansion object that was cached in the IVsExpansionClient object before the InvokeInsertionUI method was called. In fact, the only time the OnItemChosen method is called is when the InvokeInsertionUI method is called, either as a result of the user selecting a menu option that triggers the call or if the user is allowed to choose from multiple code snippets that have the same name (for example, if a code snippet shortcut matches more than one code snippet, a "disambiguation user interface" is shown to allow the user to select which code snippet to actually insert).

Return to top
Show: