Ein Symbol umbenennen

Nach oben zu Refactoring – Anleitungen - Index

Bei der Bearbeitung von Delphi- oder C++-Code im Quelltext-Editor können Sie mit dem Menübefehl Refactor > Umbenennen Bezeichner umbenennen.

Bezeichner können umbenannt werden, wenn die Originalbezeichnerdeklaration sich in dem Projekt oder in einem Projekt befindet, von dem Ihr Projekt abhängig ist, und dieses Projekt sich in derselben geöffneten Projektgruppe befindet. Typnamen, Methodennamen, Variablen, Felder und andere Bezeichner können umbenannt werden. In Delphi können mit Generics verwendete Bezeichner umbenannt werden.

Umbenennen eines Bezeichners in Delphi

Führen Sie die folgenden Schritte aus, um einen Bezeichner in Delphi umzubenennen:

1. Klicken Sie mit der rechten Maustaste im Quelltext-Editor auf den Bezeichner.
2. Wählen Sie den Menübefehl Refactor > Umbenennen Bezeichnertyp 'Bezeichnername' aus. Das Dialogfeld Umbenennen Bezeichnertyp 'Bezeichnername' wird angezeigt. Bezeichnername ist der tatsächliche Name des ausgewählten Bezeichners und Bezeichnertyp gibt dessen Typ an (Methode, Variable, Feld usw.).

   

3. Geben Sie den neuen Bezeichnernamen in das Feld Neuer Name ein.

   

4. Aktivieren Sie das Kontrollkästchen Vor Refactoring Referenzen anzeigen, um die Änderungen Ihrer Projektdateien in der Vorschau anzuzeigen. Wenn diese Option deaktiviert ist, wird das Refactoring ohne Vorschau der Änderungen sofort ausgeführt.
5. Klicken Sie auf OK. Im Bereich Refactorings wird jedes Vorkommen des zu ändernden Bezeichners angezeigt.

   

6. Überprüfen Sie die vorgeschlagenen Änderungen im Bereich Refactorings, und klicken Sie auf das Symbol Refactoring übernehmen , um alle aufgeführten Refactorings durchzuführen. Sie können auch auf das Symbol Refactoring entfernen klicken, um das ausgewählte Refactoring zu entfernen.

Hinweis: Der Kontextmenübefehl Refactor > Umbenennen Bezeichnertyp 'Bezeichnername' berücksichtigt die Groß-/Kleinschreibung. Wenn Sie einen Methodenbezeichner auswählen, lautet der Kontextmenübefehl Umbenennen Methode 'Methodenname' . Wobei Methodenname den tatsächlichen Namen der ausgewählten Methode angibt. Dieses kontextsensitive Verhalten gilt auch für alle anderen Bezeichnertypen.

Einschränkungen (Delphi)

Für das Umbenennen von Generics gilt die folgende Einschränkung:

• Sie können Typparameter in Generics nicht umbenennen.

Das bedeutet, dass Sie bei der folgenden Deklaration:

     type
       List<Item> = class
       ...
       end;

den Bezeichner Item (das ist der Typparameter) nicht umbenennen können, aber Sie können den Bezeichner List umbenennen.

Umbenennen eines Bezeichners in C++

Führen Sie die folgenden Schritte aus, um einen Bezeichner in C++ umzubenennen:

1. Klicken Sie mit der rechten Maustaste im Quelltext-Editor auf den Bezeichner.
2. Wählen Sie den Menübefehl Refactor > Umbenennen aus. Das Dialogfeld Symbol umbenennen wird geöffnet.

   

3. Geben Sie den neuen Bezeichnernamen in das Textfeld ein.

   

4. Aktivieren Sie das Kontrollkästchen Änderungen vor der Übernahme anzeigen, um die Änderungen Ihrer Projektdateien in der Vorschau anzuzeigen. Wenn diese Option deaktiviert ist, wird das Refactoring ohne Vorschau der Änderungen sofort ausgeführt.
5. Klicken Sie auf OK. Im Bereich Patch anwenden wird jedes Vorkommen des zu ändernden Bezeichners angezeigt.

   

6. Überprüfen Sie die vorgeschlagenen Änderungen im Bereich Patch anwenden, und klicken Sie auf das Symbol Übernehmen , um alle aufgeführten Refactorings durchzuführen. Klicken Sie auf das Symbol Löschen , um das ausgewählte Refactoring zu entfernen.

Hinweis: Für diese Funktion muss das Projekt einen durch Clang erweiterten Compiler verwenden.

Einschränkungen (C++)

Für die Refactoring-Operation "Umbenennen" für C++ gelten folgende Beschränkungen:

• Inaktiver Quelltext

Für nicht compilierten Quelltext kann kein Refactoring durchgeführt werden. Beispielsweise Quelltext in einem inaktiven Präprozessorblock.

• Makros

Wenn ein Bezeichner ein Makro ist, erkennt das Umbenennen-Refactoring das Makro nicht als Bezeichner, der umbenannt werden kann. Wenn ein umbenannter Bezeichner in einem Makro verwendet wird, erkennt das Umbenennen-Refactoring diesen Bezeichner zwar, deaktiviert ihn aber standardmäßig. Sie können diese Änderung überprüfen, den Bezeichner wieder aktivieren oder deaktiviert belassen.

• Template-Elemente

Das Umbenennen-Refactoring führt keine Umbenennungen in Templates aus.

Hinweis: Sie können Templates und deren Typen aber in einer speziellen Template-Deklaration umbenennen. Die Einschränkungen in diesem Thema betreffen nur das Umbenennen von Elementmethoden und/oder Variablen einer Template-Klasse.

• Nicht-ANSI-Zeichen

Die Refactoring-Operation "Umbenennen" unterstützt Nicht-ANSI-Zeichen in Projektnamen und Pfaden nicht.

• Komponentennamen

Die Refactoring-Operation "Umbenennen" für C++ benennt beim Umbenennen eines Verweises auf die Komponente im Code keine Komponentennamen in Formulardateien (.dfm oder .fmx) um.

Abbrechen des Umbenennen-Refactorings

Das Umbenennen-Refactoring kann im Fortschrittsdialogfeld abgebrochen werden.

Siehe auch

• Überblick zum Refactoring