IVsObjectList2.DoRename(UInt32, String, UInt32) Methode

Definition

Fordert das angegebene Listenelement, um den Umbenennenvorgang zu verwenden.

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

Parameter

index
UInt32

[in] Gibt den Index des relevanten Listenelements an.

pszNewName
String

[in] Zeiger auf eine auf null endende Zeichenfolge, die den neuen Namen enthält.

grfFlags
UInt32

[in] Flag, das angibt, dass der Index zu einer Mehrfachauswahl gehört. Die Werte werden der _VSOBJOPFLAGS-Enumeration entnommen.

Gibt zurück

Int32

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

COM-Signatur

Aus vsshell80. idl:

[C++]

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

Die Umgebung wird aufgerufen, DoRename Wenn der Benutzer einen Commit für den Rename-Vorgang ausführt Diese Methode wird erst aufgerufen CanRename , nachdem mit aufgerufen wurde pszNewName , sodass Sie die Möglichkeit haben, den Namen zu validieren. Wenn DoRename erfolgreich, wird zurückgegeben S_OK , andernfalls wird ein Fehler zurückgegeben, und die Rich-Error-Informationen werden festgelegt, um das aufgetretene Problem anzugeben

Wenn mehrere Elemente umbenannt werden sollen, gibt die Umgebung grfFlags an, um anzugeben, dass mehrere Aufrufe durchgeführt werden DoRename . Die Umgebung hat auch den grfFlags -Parameter verwendet, um das erste und das letzte Element anzugeben, das umbenannt werden soll. Sie können diese beispielsweise verwenden, um eine einzelne Rückgängig-Aktion für mehrere Datenelemente zu erstellen.

Gilt für