IVsComponentSelectorDlg2.ComponentSelectorDlg2 Method

Displays Select Component Dialog and returns selected components.

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

Syntax

'Declaration
Function ComponentSelectorDlg2 ( _
    grfFlags As UInteger, _
    pUser As IVsComponentUser, _
    cComponents As UInteger, _
    rgpcsdComponents As IntPtr(), _
    lpszDlgTitle As String, _
    lpszHelpTopic As String, _
    <OutAttribute> ByRef pxDlgSize As UInteger, _
    <OutAttribute> ByRef pyDlgSize As UInteger, _
    cTabInitializers As UInteger, _
    rgcstiTabInitializers As VSCOMPONENTSELECTORTABINIT(), _
    <OutAttribute> ByRef pguidStartOnThisTab As Guid, _
    pszBrowseFilters As String, _
    <OutAttribute> ByRef pbstrBrowseLocation As String _
) As Integer

'Usage
Dim instance As IVsComponentSelectorDlg2 
Dim grfFlags As UInteger 
Dim pUser As IVsComponentUser 
Dim cComponents As UInteger 
Dim rgpcsdComponents As IntPtr()
Dim lpszDlgTitle As String 
Dim lpszHelpTopic As String 
Dim pxDlgSize As UInteger 
Dim pyDlgSize As UInteger 
Dim cTabInitializers As UInteger 
Dim rgcstiTabInitializers As VSCOMPONENTSELECTORTABINIT()
Dim pguidStartOnThisTab As Guid 
Dim pszBrowseFilters As String 
Dim pbstrBrowseLocation As String 
Dim returnValue As Integer 

returnValue = instance.ComponentSelectorDlg2(grfFlags, _
    pUser, cComponents, rgpcsdComponents, _
    lpszDlgTitle, lpszHelpTopic, pxDlgSize, _
    pyDlgSize, cTabInitializers, rgcstiTabInitializers, _
    pguidStartOnThisTab, pszBrowseFilters, _
    pbstrBrowseLocation)

int ComponentSelectorDlg2(
    uint grfFlags,
    IVsComponentUser pUser,
    uint cComponents,
    IntPtr[] rgpcsdComponents,
    string lpszDlgTitle,
    string lpszHelpTopic,
    out uint pxDlgSize,
    out uint pyDlgSize,
    uint cTabInitializers,
    VSCOMPONENTSELECTORTABINIT[] rgcstiTabInitializers,
    out Guid pguidStartOnThisTab,
    string pszBrowseFilters,
    out string pbstrBrowseLocation
)

int ComponentSelectorDlg2(
    [InAttribute] unsigned int grfFlags, 
    [InAttribute] IVsComponentUser^ pUser, 
    [InAttribute] unsigned int cComponents, 
    [InAttribute] array<IntPtr>^ rgpcsdComponents, 
    [InAttribute] String^ lpszDlgTitle, 
    [InAttribute] String^ lpszHelpTopic, 
    [InAttribute] [OutAttribute] unsigned int% pxDlgSize, 
    [InAttribute] [OutAttribute] unsigned int% pyDlgSize, 
    [InAttribute] unsigned int cTabInitializers, 
    [InAttribute] array<VSCOMPONENTSELECTORTABINIT>^ rgcstiTabInitializers, 
    [InAttribute] [OutAttribute] Guid% pguidStartOnThisTab, 
    [InAttribute] String^ pszBrowseFilters, 
    [InAttribute] [OutAttribute] String^% pbstrBrowseLocation
)

function ComponentSelectorDlg2(
    grfFlags : uint, 
    pUser : IVsComponentUser, 
    cComponents : uint, 
    rgpcsdComponents : IntPtr[], 
    lpszDlgTitle : String, 
    lpszHelpTopic : String, 
    pxDlgSize : uint, 
    pyDlgSize : uint, 
    cTabInitializers : uint, 
    rgcstiTabInitializers : VSCOMPONENTSELECTORTABINIT[], 
    pguidStartOnThisTab : Guid, 
    pszBrowseFilters : String, 
    pbstrBrowseLocation : String
) : int

Parameters

• grfFlags
  Type: System.UInt32

  [in] Component selection flags taken from the VSCOMPSELFLAGS2 enumerator.

• pUser
  Type: Microsoft.VisualStudio.Shell.Interop.IVsComponentUser

  [in] Interface on which AddComponent will be called.

• cComponents
  Type: System.UInt32

  [in] Number of components in the rgpcsdComponents array.

• rgpcsdComponents
  Type: array<System.IntPtr[]

  [in] Prepopulation of Selected Components. Can be NULL. User has the ability to remove any of these components from the list.

• lpszDlgTitle
  Type: System.String

  [in] Dialog box caption (nulla null reference (Nothing in Visual Basic) == "Select component").

• lpszHelpTopic
  Type: System.String

  [in] F1 help topic (nulla null reference (Nothing in Visual Basic) == "VS.ComponentPicker")

• pxDlgSize
  Type: System.UInt32%

  [in,out] 0 to use default.

• pyDlgSize
  Type: System.UInt32%

  [in,out] 0 to use default.

• cTabInitializers
  Type: System.UInt32

  [in] Number of tabs.

• rgcstiTabInitializers
  Type: array<Microsoft.VisualStudio.Shell.Interop.VSCOMPONENTSELECTORTABINIT[]

  [in] Show order of tabs and their initialization info.

• pguidStartOnThisTab
  Type: System.Guid%

  [in,out] Tab to show when the dialog starts up

• pszBrowseFilters
  Type: System.String

  [in] List of filters to use in 'Browse...' dialog

• pbstrBrowseLocation
  Type: System.String%

  [in,out]Directory (initial/return value) to start the 'Browse...' dialog in

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

HRESULT IVsComponentSelectorDlg2::ComponentSelectorDlg2(
   [in] VSCOMPSELFLAGS2 grfFlags, 
   [in] IVsComponentUser *pUser, 
   [in] ULONG cComponents, 
   [in, size_is(cComponents)] PVSCOMPONENTSELECTORDATA rgpcsdComponents[], 
   [in] LPCOLESTR lpszDlgTitle, 
   [in] LPCOLESTR lpszHelpTopic, 
   [in, out] ULONG * pxDlgSize, 
   [in, out] ULONG * pyDlgSize, 
   [in] ULONG cTabInitializers, 
   [in, size_is(cTabInitializers)] VSCOMPONENTSELECTORTABINIT rgcstiTabInitializers[], 
   [in, out] GUID * pguidStartOnThisTab, 
   [in] LPCOLESTR pszBrowseFilters, 
   [in, out] BSTR *pbstrBrowseLocation
);

.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

IVsComponentSelectorDlg2 Interface

IVsComponentSelectorDlg2 Members

Microsoft.VisualStudio.Shell.Interop Namespace