IVsProject3.GenerateUniqueItemName(UInt32, String, String, String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает уникальное имя документа для заданного элемента.
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
Параметры
- itemidLoc
- UInt32
[in] Папка контейнера для генерируемого уникального имени элемента. Должно быть допустимым идентификатором элемента. Дополнительные сведения см. в разделе VSITEMID. Значение этого параметра обычно определяется itemidLoc параметром, который проект передает в AddProjectItemDlg(UInt32, Guid, IVsProject, UInt32, String, String, String, String, Int32) метод.
- pszExt
- String
[in] Расширение файла имени нового документа.
- pszSuggestedRoot
- String
[in] Если значение не равно null и не является пустым, это значение необходимо использовать как базовое имя для элемента, а также необходимо добавить числа, чтобы сделать имя уникальным. Если указано, проект должен иметь собственное корневое имя на основе pszExt расширения файла.
- pbstrItemName
- String
[out] Указатель на новое имя, которое содержит только имя, без пути к файлу элемента.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Реализации
Комментарии
Подпись COM
Из всшелл. IDL:
HRESULT IVsProject3::GenerateUniqueItemName(
[in] VSITEMID itemidLoc,
[in] LPCOLESTR pszExt,
[in] LPCOLESTR pszSuggestedRoot,
[out] BSTR * pbstrItemName
);
В диалоговом окне Добавление элемента этот метод используется для предложения имени пользователя при выборе нового элемента.