IVsObjectList.DoRename(UInt32, String, UInt32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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.