IVsAddProjectItemDlg2.AddProjectItemDlg(UInt32, Guid, IVsProject, UInt32, String, String, String, String, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Exibe a caixa de diálogo Adicionar item em nome do projeto de chamada.
public:
int AddProjectItemDlg(System::UInt32 itemidLoc, Guid % rguidProject, Microsoft::VisualStudio::Shell::Interop::IVsProject ^ pProject, System::UInt32 grfAddFlags, System::String ^ lpszExpand, System::String ^ lpszSelect, [Runtime::InteropServices::Out] System::String ^ % pbstrLocation, [Runtime::InteropServices::Out] System::String ^ % pbstrFilter, [Runtime::InteropServices::Out] int % pfDontShowAgain);
public int AddProjectItemDlg (uint itemidLoc, ref Guid rguidProject, Microsoft.VisualStudio.Shell.Interop.IVsProject pProject, uint grfAddFlags, string lpszExpand, string lpszSelect, out string pbstrLocation, out string pbstrFilter, out int pfDontShowAgain);
abstract member AddProjectItemDlg : uint32 * Guid * Microsoft.VisualStudio.Shell.Interop.IVsProject * uint32 * string * string * string * string * int -> int
Public Function AddProjectItemDlg (itemidLoc As UInteger, ByRef rguidProject As Guid, pProject As IVsProject, grfAddFlags As UInteger, lpszExpand As String, lpszSelect As String, ByRef pbstrLocation As String, ByRef pbstrFilter As String, ByRef pfDontShowAgain As Integer) As Integer
Parâmetros
- itemidLoc
- UInt32
no Identificador de item da pasta no projeto para o qual os itens devem ser adicionados. Isso é útil apenas para projetos baseados em diretório. Os projetos não baseados em diretório passam VSITEMID_ROOT. A caixa de diálogo Adicionar item não usa o parâmetro, exceto para passá-lo de volta para o AddItemWithSpecific(UInt32, VSADDITEMOPERATION, String, UInt32, String[], IntPtr, UInt32, Guid, String, Guid, VSADDRESULT[]) método.
- rguidProject
- Guid
no Identificador para o tipo do projeto. Registre esse parâmetro na subchave projetos da Microsoft Visual Studio chave do registro. A caixa de diálogo usa as seguintes informações sob essa chave: o valor ItemTemplateDir, que contém o caminho para o diretório que contém modelos de item para esse tipo de projeto. A chave filtros, que é usada para construir filtros abertos para a guia existente. Itens e filtros específicos para este tipo de projeto, que são exibidos na caixa de diálogo.
- pProject
- IVsProject
no Ponteiro para a IVsProject interface específica que a caixa de diálogo usa para gerar nomes padrão para cada item chamando o método da interface GenerateUniqueItemName(UInt32, String, String, String) e fazer com que os itens sejam adicionados ao projeto chamando o AddItem(UInt32, VSADDITEMOPERATION, String, UInt32, String[], IntPtr, VSADDRESULT[]) método.
- grfAddFlags
- UInt32
no Os valores de sinalizador obtidos da __VSADDITEMFLAGS enumeração que modificam o comportamento da caixa de diálogo.
- lpszExpand
- String
no Subpasta do diretório de modelo de item para selecionar e expandir, se ele tiver subpastas próprios. Esse parâmetro simplesmente inicializa o estado da árvore e não afeta o que é o diretório de modelo de item.
- lpszSelect
- String
no Item dentro da pszExpand pasta a ser selecionada. O projeto usa esse parâmetro para implementar um comportamento adesivo para o item selecionado. Esse parâmetro substitui o comportamento padrão da caixa de diálogo, que é selecionar o primeiro item na pasta.
- pbstrLocation
- String
[entrada, saída] Ponteiro para o campo de local (valor inicial/final). Esse parâmetro será usado somente se você especificar VSADDITEM_ShowLocationField . Para especificar um comportamento adesivo para o campo local, que é o comportamento recomendado, lembre-se do valor do último local e passá-lo novamente quando você abrir a caixa de diálogo novamente.
- pbstrFilter
- String
[entrada, saída] Inicializa e retorna o valor final da cadeia de caracteres de filtro (na guia existente). 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 do último valor do campo de filtro e passá-lo novamente quando você abrir a caixa de diálogo novamente.
- pfDontShowAgain
- Int32
fora Determina se o usuário selecionou ou desmarco a opção não mostrar esta caixa de diálogo novamente. Esse parâmetro será usado somente se você especificar VSADDITEM_ShowDontShowAgain . Para implementar a opção, que é o comportamento recomendado, chame diretamente o último método do modelo de item selecionado AddItem(UInt32, VSADDITEMOPERATION, String, UInt32, String[], IntPtr, VSADDRESULT[]) . Normalmente, um projeto manterá uma opção DontShowAgain separada para cada tipo de item, como formulário, módulo e classe.
Retornos
Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.
Implementações
Comentários
Assinatura COM
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 executar as tarefas necessárias para adicionar um item a um projeto e abri-lo em um editor. A caixa de diálogo chama o AddItem método para adicionar um arquivo ou modelo selecionado ou um assistente ao projeto.