IVsObjectList2.DoRename(UInt32, String, UInt32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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.