IVsComponentSelectorDlg3.ComponentSelectorDlg3 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 ComponentSelectorDlg3 ( _
    grfFlags As UInteger, _
    pUser As IVsComponentUser, _
    lpszDlgTitle As String, _
    lpszHelpTopic As String, _
    ByRef rguidShowOnlyThisTab As Guid, _
    ByRef rguidStartOnThisTab As Guid, _
    pszMachineName As String, _
    cTabInitializers As UInteger, _
    prgcstiTabInitializers As VSCOMPONENTSELECTORTABINIT(), _
    pszBrowseFilters As String, _
    <OutAttribute> ByRef pbstrBrowseLocation As String, _
    targetVersion As UInteger _
) As Integer

int ComponentSelectorDlg3(
    uint grfFlags,
    IVsComponentUser pUser,
    string lpszDlgTitle,
    string lpszHelpTopic,
    ref Guid rguidShowOnlyThisTab,
    ref Guid rguidStartOnThisTab,
    string pszMachineName,
    uint cTabInitializers,
    VSCOMPONENTSELECTORTABINIT[] prgcstiTabInitializers,
    string pszBrowseFilters,
    out string pbstrBrowseLocation,
    uint targetVersion
)

int ComponentSelectorDlg3(
    [InAttribute] unsigned int grfFlags, 
    [InAttribute] IVsComponentUser^ pUser, 
    [InAttribute] String^ lpszDlgTitle, 
    [InAttribute] String^ lpszHelpTopic, 
    [InAttribute] Guid% rguidShowOnlyThisTab, 
    [InAttribute] Guid% rguidStartOnThisTab, 
    [InAttribute] String^ pszMachineName, 
    [InAttribute] unsigned int cTabInitializers, 
    [InAttribute] array<VSCOMPONENTSELECTORTABINIT>^ prgcstiTabInitializers, 
    [InAttribute] String^ pszBrowseFilters, 
    [InAttribute] [OutAttribute] String^% pbstrBrowseLocation, 
    [InAttribute] unsigned int targetVersion
)

abstract ComponentSelectorDlg3 : 
        grfFlags:uint32 * 
        pUser:IVsComponentUser * 
        lpszDlgTitle:string * 
        lpszHelpTopic:string * 
        rguidShowOnlyThisTab:Guid byref * 
        rguidStartOnThisTab:Guid byref * 
        pszMachineName:string * 
        cTabInitializers:uint32 * 
        prgcstiTabInitializers:VSCOMPONENTSELECTORTABINIT[] * 
        pszBrowseFilters:string * 
        pbstrBrowseLocation:string byref * 
        targetVersion:uint32 -> int

function ComponentSelectorDlg3(
    grfFlags : uint, 
    pUser : IVsComponentUser, 
    lpszDlgTitle : String, 
    lpszHelpTopic : String, 
    rguidShowOnlyThisTab : Guid, 
    rguidStartOnThisTab : Guid, 
    pszMachineName : String, 
    cTabInitializers : uint, 
    prgcstiTabInitializers : VSCOMPONENTSELECTORTABINIT[], 
    pszBrowseFilters : String, 
    pbstrBrowseLocation : String, 
    targetVersion : uint
) : int

Parameters

• grfFlags
  Type: UInt32

  Component selection flags taken from the VSCOMPSELFLAGS enumerator.

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

  Interface on which AddComponent will be called.

• 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")

• rguidShowOnlyThisTab
  Type: Guid%

  Tab to show exclusively.

• rguidStartOnThisTab
  Type: Guid%

  Tab to show when the dialog opens

• pszMachineName
  Type: String

  Enumerate COM components on this computer.

• cTabInitializers
  Type: UInt32

  Number of tab initialization structs in prgcstiTabInitializers.

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

  Tab initialization information

• pszBrowseFilters
  Type: String

  List of filters to use in 'Browse…' dialog.

• pbstrBrowseLocation
  Type: String%

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

• targetVersion
  Type: UInt32

  Target framework version

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]  IVsComponentUser *pUser,
    [in]  LPCOLESTR lpszDlgTitle,
    [in]  LPCOLESTR lpszHelpTopic,
    [in]  REFGUID rguidShowOnlyThisTab,
    [in]  REFGUID rguidStartOnThisTab,
    [in]  LPCOLESTR pszMachineName,
    [in]  ULONG cTabInitializers,
    [in, size_is(cTabInitializers)]
         VSCOMPONENTSELECTORTABINIT *prgcstiTabInitializers,
    [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