Signatur ändern

Zweck: Ändern der Parameter einer Funktion.

Anwendung: Wenn Sie die Parameter einer Funktion neu anordnen, hinzufügen, entfernen oder ändern möchten, die an vielen Stellen verwendet werden.

Grund: Sie können diese Parameter eigenhändig manuell ändern und dann alle Aufrufe dieser Funktion suchen und nacheinander ändern, was jedoch zu Fehlern führen kann. Bei diesem Refactoringtool wird der Task automatisch ausgeführt.

Vorgehensweise:

  1. Platzieren Sie Ihren Text oder Mauszeiger auf dem Namen der zu ändernden Methode oder auf einer deren Verwendungen:

    Screenshot des Codes mit dem Mauszeiger auf der ChangeUserInfo-Funktion

  2. Führen Sie dann eine der folgenden Aktionen aus:

    • Tastatur
      • Drücken Sie STRG+R und dann STRG+O. (Ihre Tastenkombination weicht je nach ausgewähltem Profil möglicherweise ab.)
      • Drücken Sie Strg + ., um das Menü Schnellaktionen und Refactorings aufzurufen, und klicken Sie im Kontextmenü auf Signatur ändern.
    • Maus
      • Wählen Sie Bearbeiten > Umgestalten > Parameter neu anordnen aus.
      • Klicken Sie mit der rechten Maustaste auf den Code, und klicken Sie auf das Menü Schnellaktionen und Refactorings, klicken Sie dann im Kontextmenü auf Signatur ändern.
  3. Mit den Schaltflächen auf der rechten Seite im angezeigten Dialogfeld Signatur ändern können Sie die Methodensignatur ändern:

    Screenshot des Dialogfelds „Signatur ändern“ für die ChangeName()-Funktion. Die Parameter werden nach Name, Typ und zugeordnetem Wert (sofern vorhanden) aufgelistet.

    Schaltfläche Beschreibung
    Nach oben/unten Den ausgewählten Parameter in der Liste nach oben oder nach unten verschieben
    Add Einen neuen Parameter zur Liste hinzufügen
    Entfernen Den ausgewählten Parameter aus der Liste entfernen
    Änderung Ändern Sie den Typ und Namen des ausgewählten Parameters, und geben Sie an, ob er optional ist und was sein eingefügter Wert wäre
    Zurücksetzen Den ursprünglichen Zustand des ausgewählten Parameters wiederherstellen
    Alle zurücksetzen Den ursprünglichen Zustand aller Parameter wiederherstellen

    Tipp

    Verwenden Sie das Kontrollkästchen Vorschau der Verweisänderungen überspringen, wenn alle Verweise bestätigt sind, um die Änderungen sofort anzuwenden, ohne dass erst das Vorschaufenster angezeigt wird.

    Beim Hinzufügen oder Ändern eines Parameters wird das Fenster Parameter hinzufügen oder das Fenster Parameter bearbeiten angezeigt.

    Screenshot des Fensters „Parameter hinzufügen“, in dem Sie den Typ, den Namen und ob er ein Standardparameter oder optional ist festlegen können

    Hier stehen Ihnen folgende Optionen zur Verfügung:

    Eintrag Beschreibung
    Type Der Typ des Parameters (int, double, float usw.)
    Name Der Name des Parameters
    Optionaler Parameter Legt fest, dass der Parameter optional angegeben wird
    Eingefügter Wert Der Wert, der in alle Aufrufe der Funktion eingefügt wird, für die der Parameter nicht angegeben wird (nur für Hinzufügen gültig)
    Standardwert Der Wert, den die Funktion verwendet, wenn der Aufrufer keinen angibt (nur für optionale Parameter gültig)
  4. Verwenden Sie die Dropdownliste Suchbereich, um auszuwählen, ob Änderungen auf das Projekt oder auf die gesamte Projektmappe angewandt werden.

  5. Wenn Sie fertig sind, klicken Sie auf die Schaltfläche OK, um die Änderungen zu übernehmen. Stellen Sie sicher, dass die von Ihnen angeforderten Änderungen ordnungsgemäß durchgeführt werden. Verwenden Sie die Kontrollkästchen in der oberen Hälfte des Fensters, um das Umbenennen von Elementen zu aktivieren oder zu deaktivieren.

    Screenshot einer Vorschau für „Signatur ändern“. Alle Stellen, an denen die Funktion aufgerufen wird, werden in der Vorschau angezeigt, sodass Sie jede Änderung überprüfen können.

  6. Klicken Sie auf die Schaltfläche Anwenden, wenn Sie fertig sind, um die Funktion in Ihrem Quellcode zu ändern.

    Screenshot der resultierenden Änderung. Die Parameter für ChangeUserInfo() lauten jetzt: std::string lastName, std::string firstname, int age = -1