IVsObjectList.DoRename(UInt32, String, UInt32) Méthode

Définition

Demande à l'élément de liste donné d'effectuer l'opération de changement de nom.

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

Paramètres

index
UInt32

[in] Spécifie l'index de l'élément concerné de la liste.

pszNewName
String

[in] Pointeur vers une chaîne se terminant par null et contenant le nouveau nom.

grfFlags
UInt32

[in] Indicateur qui spécifie si l'index fait partie d'une sélection multiple. Les valeurs proviennent de l'énumération _VSOBJOPFLAGS.

Retours

Int32

Si la méthode réussit, retourne S_OK. En cas d'échec, retourne un code d'erreur.

Remarques

Signature COM

À partir de vsshell. idl :

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

L’environnement appelle DoRename lorsque l’utilisateur valide l’opération de changement de nom. Cette méthode est appelée uniquement après que CanRename a été appelé avec le pszNewName afin que vous ayez eu la possibilité de valider le nom. En cas de DoRename tentative, retourne S_OK , sinon retourne une erreur dans HR et définit les informations d’erreur détaillées pour indiquer le problème rencontré.

Si plusieurs éléments doivent être renommés, l’environnement est défini grfFlags pour indiquer que plusieurs DoRename appels sont effectués. L’environnement utilisait également le grfFlags paramètre pour indiquer le premier et le dernier élément à renommer. Vous pouvez l’utiliser, par exemple, pour créer une seule action d’annulation pour plusieurs éléments de données.

S’applique à