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.

Возвращаемое значение

Int32

Если метод завершается успешно, возвращает значение 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);                           

Применяется к