IVsFilterAddProjectItemDlg2::FilterListItemByCategory Method (Guid, String^, Int32)

Visual Studio 2015

Filters files by category.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)

Syntax

C++

int FilterListItemByCategory(
	[InAttribute] Guid% rguidProjectItemTemplates,
	String^ pszCategoryName,
	[OutAttribute] int% pfFilter
)

Parameters

rguidProjectItemTemplates: Type: System::Guid
[in] GUID of the project supplying the item templates.

pszCategoryName: Type: System::String^
[in] Pointer to a null terminated string containing the category template name.

pfFilter: Type: System::Int32
[out] Set to true to filter out the specified item. Set to false to display the item.

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 vsshell.idl:

C++

HRESULT IVsFilterAddProjectItemDlg2::FilterListItemByCategory(
   [in] REFGUID rguidProjectItemTemplates,
   [in] LPCOLESTR pszCategoryName,
   [out] BOOL *pfFilter
);

The environment passes in a project GUID and a category name. Return false to display items in the category and true to filter the category. You specify categories in your Template Directory Description (.Vsdir) Files.