IVsHierarchyRefactorNotify.OnBeforeGlobalSymbolRenamed(UInt32, UInt32[], UInt32, String[], String, Int32) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вызывается при начале переименования символа.
public:
int OnBeforeGlobalSymbolRenamed(System::UInt32 cItemsAffected, cli::array <System::UInt32> ^ rgItemsAffected, System::UInt32 cRQNames, cli::array <System::String ^> ^ rglpszRQName, System::String ^ lpszNewName, int promptContinueOnFail);
public:
int OnBeforeGlobalSymbolRenamed(unsigned int cItemsAffected, Platform::Array <unsigned int> ^ rgItemsAffected, unsigned int cRQNames, Platform::Array <Platform::String ^> ^ rglpszRQName, Platform::String ^ lpszNewName, int promptContinueOnFail);
int OnBeforeGlobalSymbolRenamed(unsigned int cItemsAffected, std::Array <unsigned int> const & rgItemsAffected, unsigned int cRQNames, std::Array <std::wstring const &> const & rglpszRQName, std::wstring const & lpszNewName, int promptContinueOnFail);
public int OnBeforeGlobalSymbolRenamed (uint cItemsAffected, uint[] rgItemsAffected, uint cRQNames, string[] rglpszRQName, string lpszNewName, int promptContinueOnFail);
abstract member OnBeforeGlobalSymbolRenamed : uint32 * uint32[] * uint32 * string[] * string * int -> int
Public Function OnBeforeGlobalSymbolRenamed (cItemsAffected As UInteger, rgItemsAffected As UInteger(), cRQNames As UInteger, rglpszRQName As String(), lpszNewName As String, promptContinueOnFail As Integer) As Integer
Параметры
- cItemsAffected
- UInt32
Число файлов, на которые влияет переименование.
- rgItemsAffected
- UInt32[]
Массив объектов VSITEMID, определяющий файлы, которые будут затронуты.
- cRQNames
- UInt32
Количество переименованных символов. Число может быть больше единицы, если перегруженный символ переименован.
- rglpszRQName
- String[]
Имя символа перед переименованием.
- lpszNewName
- String
Имя символа после переименования.
- promptContinueOnFail
- Int32
true для запроса пользователя, продолжить ли операцию переименования если один или несколько разработчиков IVsRefactorNotify завершаются неудачно; в противном случае – значение false.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Чтобы прерывать операцию переименования, HRESULT должен содержать один из следующих кодов ошибок:
E_ABORT
OLE_E_PROMPTSAVECANCELLED
OLECMDERR_E_CANCELED
HR_E_CSHARP_USER_CANCEL
Символ с таким именем может иметь более одного вхождения, если язык допускает операции перегрузки, например перегрузку методов:
void SomeMethod() {}
void SomeMethod(int i) {}
Подпись COM
Из vsshell80. IDL:
HRESULT OnBeforeGlobalSymbolRenamed(
[in] ULONG cItemsAffected,
[in, size_is(cItemsAffected)] VSITEMID rgItemsAffected[],
[in] ULONG cRQNames,
[in, size_is(cRQNames)] LPCOLESTR rglpszRQName[],
[in] LPCOLESTR lpszNewName,
[in] BOOL promptContinueOnFail);