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

Artigo
08/09/2016

Publicado: agosto de 2016

Exibe o Adicionar Item caixa de diálogo em nome do 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
Type: System.UInt32

[in] Identificador do item da pasta do projeto para o 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 Adicionar Item caixa de diálogo não usa o parâmetro exceto to passá-lo para o AddItemWithSpecific método.

rguidProject
Type: System.Guid

[in] Identificador para o tipo do projeto. Registre esse parâmetro na subchave projetos da chave do registro do Microsoft Visual Studio. A caixa de diálogo usa as informações a seguir sob essa chave:

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

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

Filtros específicos para este projeto e itens de tipo, um que é exibido na caixa de diálogo.

pProject
Type: Microsoft.VisualStudio.Shell.Interop.IVsProject

[in] Ponteiro para o específico IVsProject interface que usa a caixa de diálogo 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
Type: System.UInt32

[in] Valores obtidos do sinalizador de __VSADDITEMFLAGS enumeração que modificam o comportamento da caixa de diálogo.

lpszExpand
Type: System.String

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

lpszSelect
Type: System.String

[in] Item dentro do pszExpand pasta a ser selecionado. O projeto usa esse parâmetro para implementar um comportamento 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
Type: System.String

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

pbstrFilter
Type: System.String

[no, out] Inicializa e retorna o valor final da cadeia de caracteres de filtro (sobre o existente guia). Especifique VSADDITEM_AllowStickyFilter para retornar um valor para a cadeia de caracteres de filtro. Para especificar o comportamento adesivo para o campo de filtro, que é o comportamento recomendado, lembre-se o último valor do campo de filtro e passá-lo de volta quando abre a caixa de diálogo.

pfDontShowAgain
Type: System.Int32

[out] Determina se o usuário selecionado ou desmarcado o não mostrar esta caixa de diálogo novamente opção. Esse parâmetro é usado somente se você especificar VSADDITEM_ShowDontShowAgain. Para implementar a opçã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 DontShowAgain separada para cada tipo de item, como o formulário, módulo e classe.

Valor de retorno

Type: System.Int32

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

Comentários

COM assinatura

De vsshell80.idl:

HRESULT IVsAddProjectItemDlg::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 executar as tarefas necessárias para adicionar um item a um projeto e abra-o em um editor. As chamadas de caixa de diálogo de AddItem método para adicionar um arquivo selecionado ou um assistente ou modelo para o projeto.

Consulte também

Interface IVsAddProjectItemDlg
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Partilhar via