IVsComponentSelectorDlg3.ComponentSelectorDlg4 Method

Displays Browse … Dialog and returns selected components.

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

Syntax

'Declaration
Function ComponentSelectorDlg4 ( _
    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, _
    targetVersion As UInteger _
) As Integer

int ComponentSelectorDlg4(
    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,
    uint targetVersion
)

int ComponentSelectorDlg4(
    [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, 
    [InAttribute] unsigned int targetVersion
)

abstract ComponentSelectorDlg4 : 
        grfFlags:uint32 * 
        pUser:IVsComponentUser * 
        cComponents:uint32 * 
        rgpcsdComponents:IntPtr[] * 
        lpszDlgTitle:string * 
        lpszHelpTopic:string * 
        pxDlgSize:uint32 byref * 
        pyDlgSize:uint32 byref * 
        cTabInitializers:uint32 * 
        rgcstiTabInitializers:VSCOMPONENTSELECTORTABINIT[] * 
        pguidStartOnThisTab:Guid byref * 
        pszBrowseFilters:string * 
        pbstrBrowseLocation:string byref * 
        targetVersion:uint32 -> int

function ComponentSelectorDlg4(
    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, 
    targetVersion : uint
) : int

Parameters

• grfFlags
  Type: UInt32

  Component selection flags taken from the VSCOMPSELFLAGS2 enumerator.

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

  Interface on which AddComponent will be called.

• cComponents
  Type: UInt32

  Number of components in the rgpcsdComponents array.

• rgpcsdComponents
  Type: array<IntPtr[]

  Prepopulation of Selected Components. Can be nulla null reference (Nothing in Visual Basic). User has the ability to remove any of these components from the list.

• lpszDlgTitle
  Type: String

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

• lpszHelpTopic
  Type: String

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

• pxDlgSize
  Type: UInt32%

  0 to use default.

• pyDlgSize
  Type: UInt32%

  0 to use default.

• cTabInitializers
  Type: UInt32

  Number of tabs.

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

  Show order of tabs and their initialization info.

• pguidStartOnThisTab
  Type: Guid%

  Tab to show when the dialog starts up

• pszBrowseFilters
  Type: String

  List of filters to use in 'Browse…'.

• pbstrBrowseLocation
  Type: String%

  Directory (initial/return value) to start the 'Browse…' dialog in.

• targetVersion
  Type: UInt32

Return Value

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

Remarks

COM Signature

From vsshell90.idl:

HRESULT ComponentSelectorDlg3(
    [in]  VSCOMPSELFLAGS grfFlags,
    [in]  ULONG cComponents,
    [in, size_is(cComponents)] PVSCOMPONENTSELECTORDATA rgpcsdComponents[],
    [in]  LPCOLESTR lpszDlgTitle,
    [in]  LPCOLESTR lpszHelpTopic,
    [in, out]  ULONG * pxDlgSize,
    [in, out]  ULONG * pyDlgSize,
    [in]  REFGUID rguidShowOnlyThisTab,
    [in]  ULONG cTabInitializers,
    [in, size_is(cTabInitializers)]
         VSCOMPONENTSELECTORTABINIT *prgcstiTabInitializers,
    [in, out] GUID *  pguidStartOnThisTab,
    [in]  LPCOLESTR pszBrowseFilters,
    [in, out] BSTR *pbstrBrowseLocation,
    [in]  TARGETFRAMEWORKVERSION targetVersion
);

.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

IVsComponentSelectorDlg3 Interface

Microsoft.VisualStudio.Shell.Interop Namespace