IVsProject.GenerateUniqueItemName(UInt32, String, String, String) Method

Reference

Definition

Namespace:: Microsoft.VisualStudio.Shell.Interop

Assembly:: Microsoft.VisualStudio.Shell.Interop.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

Package:: Microsoft.VisualStudio.Interop v17.11.40262

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Generates a unique document name for a given 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

Parameters

itemidLoc: UInt32

[in] Container folder for the unique item name being generated. Should be a valid item identifier. For further information, see VSITEMID. The value of this parameter is typically determined by the itemidLoc parameter that the project passes to the AddProjectItemDlg(UInt32, Guid, IVsProject, UInt32, String, String, String, String, Int32) method.

pszExt: String

[in] File extension of the new document name.

pszSuggestedRoot: String

[in] If not null or empty, this value should be used as the base name for the item, and numbers should be appended to make the name unique. If supplied, the project should make up its own root name based on the pszExt file extension.

pbstrItemName: String

[out] Pointer to the new name, which contains the name only, not the item's file path.

Returns

Int32

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From vsshell.idl:

HRESULT IVsProject::GenerateUniqueItemName(  
   [in] VSITEMID itemidLoc,  
   [in] LPCOLESTR pszExt,  
   [in] LPCOLESTR pszSuggestedRoot,  
   [out] BSTR * pbstrItemName  
);

The Add Item dialog box uses this method to suggest a name for the user when a new item is selected.

Applies to

通过