IVsProject3.GenerateUniqueItemName(UInt32, String, String, String) 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.
Gera um nome de documento exclusivo para um determinado item.
public:
int GenerateUniqueItemName(System::UInt32 itemidLoc, System::String ^ pszExt, System::String ^ pszSuggestedRoot, [Runtime::InteropServices::Out] System::String ^ % pbstrItemName);
int GenerateUniqueItemName(unsigned int itemidLoc, std::wstring const & pszExt, std::wstring const & pszSuggestedRoot, [Runtime::InteropServices::Out] std::wstring const & & pbstrItemName);
public int GenerateUniqueItemName (uint itemidLoc, string pszExt, string pszSuggestedRoot, out string pbstrItemName);
abstract member GenerateUniqueItemName : uint32 * string * string * string -> int
Public Function GenerateUniqueItemName (itemidLoc As UInteger, pszExt As String, pszSuggestedRoot As String, ByRef pbstrItemName As String) As Integer
Parâmetros
- itemidLoc
- UInt32
no Pasta de contêiner para o nome de item exclusivo que está sendo gerado. Deve ser um identificador de item válido. Para obter mais informações, consulte VSITEMID . O valor desse parâmetro normalmente é determinado pelo itemidLoc parâmetro que o projeto passa para o AddProjectItemDlg(UInt32, Guid, IVsProject, UInt32, String, String, String, String, Int32) método.
- pszExt
- String
no Extensão de arquivo do novo nome do documento.
- pszSuggestedRoot
- String
no Se não null estiver ou vazio, esse valor deve ser usado como o nome base para o item e os números devem ser acrescentados para tornar o nome exclusivo. Se fornecido, o projeto deve criar seu próprio nome de raiz com base na pszExt extensão de arquivo.
- pbstrItemName
- String
fora Ponteiro para o novo nome, que contém apenas o nome, não o caminho do arquivo do item.
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 IVsProject3::GenerateUniqueItemName(
[in] VSITEMID itemidLoc,
[in] LPCOLESTR pszExt,
[in] LPCOLESTR pszSuggestedRoot,
[out] BSTR * pbstrItemName
);
A caixa de diálogo Adicionar item usa esse método para sugerir um nome para o usuário quando um novo item é selecionado.