Dateien umbenennen

Nach oben zu So erstellen Sie VCL-Formularanwendungen

Die Erstellung dieser VCL-Anwendung umfasst die folgenden grundlegenden Schritte:

1. Ein Projektverzeichnis erstellen, das eine umzubenennende Datei enthält.
2. Ein VCL-Formular mit einer Schaltfläche und einem Label erstellen.
3. Quelltext für das Umbenennen der Datei schreiben.
4. Die Anwendung ausführen.

So erstellen Sie ein Projektverzeichnis und die zu kopierende Textdatei:

1. Legen Sie ein Verzeichnis an, in dem die Projektdateien gespeichert werden.
2. Erstellen Sie eine Textdatei, oder kopieren Sie eine Textdatei in das Projektverzeichnis, und speichern Sie diese unter dem Namen MyFile.txt.

So erstellen Sie ein VCL-Formular mit einer Schaltfläche und einem Label:

1. Wählen Sie Datei > Neu > Weitere > Delphi-Projekte oder C++Builder-Projekte, und doppelklicken Sie auf das Symbol VCL-Formularanwendung.Der VCL-Formular-Designer wird angezeigt.
2. Ziehen Sie aus der Seite Standard der Tool-Palette eine TButton-Komponente in das Formular.
3. Ziehen Sie aus der Seite Standard der Tool-Palette eine TLabel-Komponente in das Formular.

So schreiben Sie die Prozedur für das Umbenennen von Dateien:

1. Markieren Sie im Formular das Steuerelement Button1.
2. Doppelklicken Sie im Objektinspektor auf der Registerkarte Ereignisse auf die Aktion OnClick. Der Quelltext-Editor wird angezeigt. Der Cursor befindet sich bereits im Block der Ereignisbehandlungsroutine TForm1.Button1Click (Delphi) bzw. TForm1::Button1Click (C++).
3. Geben Sie an der Cursorposition folgenden Quelltext ein:

if not RenameFile('MyFile.txt', 'YourFile.txt') then
Label1.Caption := 'Fehler beim Umbenennen der Datei!';

if( !RenameFile( "..\\MyFile.txt", "..\\YourFile.txt" )
  Label1–>Caption = "Fehler beim Umbenennen der Datei";
// Bei den Dateiparametern wird davon ausgegangen, dass sich das Zielverzeichnis im Projektverzeichnis befindet.

Anmerkung:  Sie können Dateien mit RenameFile nicht über Laufwerke hinweg umbenennen (verschieben). Zu diesem Zweck müssen Sie zunächst die Datei kopieren und dann die alte Dateiversion löschen. RenameFile ist in der Laufzeitbibliothek ein Wrapper für die Windows-API-Funktion MoveFile. Daher funktioniert auch MoveFile nicht über Laufwerke hinweg.

So führen Sie die Anwendung aus:

1. Speichern Sie die Projektdatei, und wählen Sie dann Start > Ausführen, um die Anwendung zu compilieren und auszuführen. Das Formular wird angezeigt.
2. Klicken Sie auf die Schaltfläche. Wenn keine Meldung im Label angezeigt wird, überprüfen Sie den Dateinamen im Projektverzeichnis. MyFile.txt muss in YourFile.txt umbenannt worden sein.
3. Wenn der Titel die Fehlermeldung enthält, überprüfen Sie den Code der Ereignisbehandlungsroutine.

Siehe auch

• Überblick zu VCL
• VCL-Formularanwendung erstellen