IVsComponentSelectorDlg3.ComponentSelectorDlg3 Method

Article
03/06/2013

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: System.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: System.String
Dialog box caption (nulla null reference (Nothing in Visual Basic) == "Select component").

lpszHelpTopic
Type: System.String
F1 help topic (nulla null reference (Nothing in Visual Basic) == "VS.ComponentPicker")

rguidShowOnlyThisTab
Type: System.Guid%
Tab to show exclusively.

rguidStartOnThisTab
Type: System.Guid%
Tab to show when the dialog opens

pszMachineName
Type: System.String
Enumerate COM components on this computer.

cTabInitializers
Type: System.UInt32
Number of tab initialization structs in prgcstiTabInitializers.

prgcstiTabInitializers
Type: array<Microsoft.VisualStudio.Shell.Interop.VSCOMPONENTSELECTORTABINIT[]
Tab initialization information

pszBrowseFilters
Type: System.String
List of filters to use in 'Browse…' dialog.

pbstrBrowseLocation
Type: System.String%
Directory (initial/return value) to start the 'Browse…' dialog in.

targetVersion
Type: System.UInt32
Target framework version

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 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.

Share via