IVsObjectList2.DoRename(UInt32, String, UInt32) Método

Definição

Solicita que o item de lista especificado faça a operação de renomeação.

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

Parâmetros

index
UInt32

no Especifica o índice do item de lista de interesse.

pszNewName
String

no Ponteiro para uma cadeia de caracteres terminada em nulo que contém o novo nome.

grfFlags
UInt32

no Sinalizador que indica que o índice faz parte de uma seleção múltipla. Os valores são obtidos da _VSOBJOPFLAGS enumeração.

Retornos

Int32

Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.

Comentários

Assinatura COM

De vsshell80. idl:

[C++]

HRESULT IVsObjectList2::DoRename(  
   [in] ULONG Index,   
   [in] LPCOLESTR pszNewName,   
   [in] VSOBJOPFLAGS grfFlags  
);  

O ambiente chama DoRename quando o usuário confirma a operação de renomeação. Esse método é chamado somente depois CanRename de ter sido chamado com o pszNewName para que você tenha tido a oportunidade de validar o nome. Se DoRename for bem sucedido, retornará S_OK , caso contrário, retornará um erro e defina as informações de erro avançadas para indicar o problema encontrado.

Se vários itens forem renomeados, o ambiente definirá grfFlags para indicar que várias DoRename chamadas estão sendo feitas. O ambiente também usou o grfFlags parâmetro para indicar o primeiro e o último item a ser renomeado. Você pode usar isso, por exemplo, para criar uma única ação de desfazer para os vários itens de dados.

Aplica-se a