Método IVsAddProjectItemDlg2.AddProjectItemDlg (UInt32, Guid, IVsProject, UInt32, String, String, String, String, Int32)

Artigo
08/03/2016

Publicado: abril de 2016

Exibe o Add Item caixa de diálogo de nome para o projeto de chamada.

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

Sintaxe

int AddProjectItemDlg(
    uint itemidLoc,
    [InAttribute] ref Guid rguidProject,
    IVsProject pProject,
    uint grfAddFlags,
    string lpszExpand,
    string lpszSelect,
    ref string pbstrLocation,
    ref string pbstrFilter,
    out int pfDontShowAgain
)

int AddProjectItemDlg(
    unsigned int itemidLoc,
    [InAttribute] Guid% rguidProject,
    IVsProject^ pProject,
    unsigned int grfAddFlags,
    String^ lpszExpand,
    String^ lpszSelect,
    String^% pbstrLocation,
    String^% pbstrFilter,
    [OutAttribute] int% pfDontShowAgain
)

abstract AddProjectItemDlg : 
        itemidLoc:uint32 *
        rguidProject:Guid byref *
        pProject:IVsProject *
        grfAddFlags:uint32 *
        lpszExpand:string *
        lpszSelect:string *
        pbstrLocation:string byref *
        pbstrFilter:string byref *
        pfDontShowAgain:int byref -> int

Function AddProjectItemDlg (
    itemidLoc As UInteger,
    <InAttribute> ByRef rguidProject As Guid,
    pProject As IVsProject,
    grfAddFlags As UInteger,
    lpszExpand As String,
    lpszSelect As String,
    ByRef pbstrLocation As String,
    ByRef pbstrFilter As String,
    <OutAttribute> ByRef pfDontShowAgain As Integer
) As Integer

Parâmetros

itemidLoc
[in] Identificador de item da pasta do projeto ao qual os itens devem ser adicionados.Isso é útil somente para projetos baseados em diretório.Projetos não baseados em diretório passam VSITEMID_ROOT.O Add Item caixa de diálogo não usa o parâmetro, exceto para passar para o AddItemWithSpecific método.

rguidProject
[in] Identificador de tipo do projeto.Registrar este parâmetro na subchave de projetos da Microsoft Visual Studio chave do registro.A caixa de diálogo usa as informações a seguir nessa chave:

O valor de ItemTemplateDir, que contém o caminho para o diretório que contém modelos de item para esse tipo de projeto.

A chave de filtros, que é usada para construir filtros abertos para a guia existente.

Itens e filtros específicos para este projeto tipo, que são exibidos na caixa de diálogo.

pProject
[in] Ponteiro para o específico do IVsProject interface que a caixa de diálogo usa para gerar nomes padrão para cada item chamando a interface GenerateUniqueItemName método e para fazer com que os itens a serem adicionados ao projeto, chamando o AddItem método.

grfAddFlags
[in] Sinalizar valores extraídos de __VSADDITEMFLAGS enumeração que modificam o comportamento da caixa de diálogo.

lpszExpand
[in] Subpasta do diretório de modelo de item para selecionar e para expandir, se ele tiver subpastas de si próprio.Este parâmetro simplesmente inicializa o estado da árvore e não afeta o que é o diretório de modelos de item.

lpszSelect
[in] Dentro do item a pszExpand a pasta a ser selecionado.O projeto usa esse parâmetro para implementar um comportamento de auto-adesivo para o item selecionado.Esse parâmetro substitui o comportamento padrão para a caixa de diálogo é selecionar o primeiro item na pasta.

pbstrLocation
[in, out] Ponteiro para o campo de local (valor inicial/final).Este parâmetro é usado somente se você especificar VSADDITEM_ShowLocationField.Para especificar um comportamento de auto-adesivo para o campo de local, que é o comportamento recomendado, lembre-se o último valor de campo de local e passá-lo novamente no quando você abre a caixa de diálogo novamente.

pbstrFilter
[in, out] Inicializa e retorna o valor final da seqüência de caracteres de filtro (sobre o existente guia).Especificar VSADDITEM_AllowStickyFilter para retornar um valor para a seqüência de caracteres de filtro.Para especificar o comportamento de auto-adesivo para o campo de filtro, que é o comportamento recomendado, lembre-se o último valor de campo de filtro e passá-lo novamente no quando você abre a caixa de diálogo novamente.

pfDontShowAgain
[out] Determina se o usuário marcada ou desmarcada a não mostrar esta caixa de diálogo novamente opção.Este parâmetro é usado somente se você especificar VSADDITEM_ShowDontShowAgain.Para implementar a opção, o que é o comportamento recomendado, chamar diretamente o último item selecionado do modelo próprio AddItem método.Normalmente, um projeto manterá uma opção de DontShowAgain separada para cada tipo de item, como, por exemplo, formulário, módulo e classe.

Valor de retorno

Type: System.Int32

Se o método for bem-sucedido, ele retorna S_OK.Se ele falhar, ele retorna um código de erro.

Implementações

IVsAddProjectItemDlg.AddProjectItemDlg(UInt32, Guid, IVsProject, UInt32, String, String, String, String, Int32)

Comentários

COM assinatura

De vsshell.idl:

HRESULT IVsAddProjectItemDlg2::AddProjectItemDlg(
   [in] VSITEMID itemidLoc,
   [in] REFGUID rguidProject,
   [in] IVsProject *pProject,
   [in] VSADDITEMFLAGS grfAddFlags,
   [in] LPCOLESTR lpszExpand,
   [in] LPCOLESTR lpszSelect,
   [in, out] BSTR *pbstrLocation,
   [in, out] BSTR *pbstrFilter,
   [out] BOOL *pfDontShowAgain
);

O chamador deve implementar IVsProject para usar esse método.A caixa de diálogo é apenas um mecanismo de seleção.O chamador deve realizar as tarefas necessárias para adicionar um item a um projeto e abri-lo em um editor.As chamadas de caixa de diálogo de AddItem método para adicionar um arquivo selecionado ou o modelo ou um Assistente para o projeto.

Consulte também

Interface IVsAddProjectItemDlg2
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Compartilhar via