IVsObjectList2.DoRename(UInt32, String, UInt32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.