IVsObjectList2.DoRename(UInt32, String, UInt32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Запрашивает, чтобы указанный элемент списка выполнил операцию переименования.
public:
int DoRename(System::UInt32 index, System::String ^ pszNewName, System::UInt32 grfFlags);
public:
int DoRename(unsigned int index, Platform::String ^ pszNewName, unsigned int grfFlags);
int DoRename(unsigned int index, std::wstring const & pszNewName, unsigned int grfFlags);
public int DoRename (uint index, string pszNewName, uint grfFlags);
abstract member DoRename : uint32 * string * uint32 -> int
Public Function DoRename (index As UInteger, pszNewName As String, grfFlags As UInteger) As Integer
Параметры
- index
- UInt32
[in] Определяет индекс представляющего интерес элемента списка.
- pszNewName
- String
[in] Указатель на заканчивающуюся нулем строку, содержащую новое имя.
- grfFlags
- UInt32
[in] Флаг, обозначающий, что индекс является частью множественного выбора. Значения берутся из перечисления _VSOBJOPFLAGS.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Подпись COM
Из vsshell80. IDL:
[C++]
HRESULT IVsObjectList2::DoRename(
[in] ULONG Index,
[in] LPCOLESTR pszNewName,
[in] VSOBJOPFLAGS grfFlags
);
Среда вызывает, DoRename когда пользователь фиксирует операцию переименования. Этот метод вызывается только после CanRename вызова метода с тем pszNewName , что у вас есть шанс проверить имя. При DoRename успешном выполнении возвращается значение S_OK , в противном случае возвращается ошибка и устанавливаются подробные сведения об ошибке, указывающие на обнаруженную проблему.
Если требуется переименовать несколько элементов, среда задается grfFlags для указания на то, что выполняется несколько DoRename вызовов. Среда также использовала grfFlags параметр для указания первого и последнего переименованного элемента. Это можно использовать, например, для создания одного действия отмены для нескольких элементов данных.