Dialog Import Files

Import Files

The Import Files dialog imports external files and folders from the host system into the active disk image.

It provides control over the destination directory, filename format, timestamp handling, and overwrite behavior, and clearly reports how much space and how many directory entries are required before the import is performed.

Changes are staged and are not applied until Import is clicked.

---

How to Open

The Import Files dialog can be opened from multiple locations:

• Menu: Edit -> Import Files
• Toolbar: Import Files
• Context Menu:
  • Import Files (imports into the selected directory)
  • Import Files Here (imports at a specific directory position)
• Automatically after dragging files or folders onto the main window, when the alternate drag-and-drop target is not enabled (see Import using Drag and Drop)

---

Overview

The dialog presents a list of files and folders selected for import and provides control over how those items are added to the disk image.

Files are grouped by destination directory, and only checked entries are imported.

---

Import into Directory

A dropdown at the top of the dialog chooses the destination directory for the import.

• The list enumerates every directory that exists in the active image, with the root shown as (Root) and subdirectories shown using their full path.
• The initial selection reflects the directory the dialog was opened from; for example, opening the dialog from a file's context menu preselects that file's parent directory.
• Changing the selection rebuilds the file list and updates space and entry totals for the newly chosen directory.
• Selection state for individual files is preserved across directory changes.

---

Options

The Options section controls how imported files are represented in the image.

• Long File Names
  Imports long file name entries.
  Automatically unchecked and disabled when none of the source files require a long file name.

• NT Extensions
  Enables NT-specific filename extensions.
  Available only when Long File Names is enabled and at least one source file is eligible.

• Created Date
  Imports and assigns the file creation date where supported.

• Last Accessed Date
  Imports and assigns the last accessed date where supported.

• Overwrite existing files
  Controls how files that match an existing entry in the destination directory are handled.

  • Checked (default): existing files are replaced in place.
  • Unchecked: existing files are left untouched and the imported file is renamed to avoid a collision.

  Enabled only when at least one source file matches an existing entry. When no collisions exist, the checkbox is shown disabled.

---

File List

The file list displays all files selected for import, grouped by their resulting directory path relative to the chosen destination.

Drag and Drop

Additional files and folders can be dragged and dropped directly onto the file list. New entries are appended to the list and existing selections are preserved.

Columns

• File Name
  Name of the file to be imported. Each entry has a checkbox controlling whether it will be included.

• Action
  What will happen when the file is imported:

  • Add — the file does not exist in the destination and will be added
  • Replace — the file matches an existing entry and Overwrite existing files is on
  • Rename — the file matches an existing entry but cannot replace it (either overwrite is off, or the existing entry is of an incompatible type such as a directory or volume label)
  • Skip — the file is unchecked or is too large to fit in the image

• Size
  Size of the source file.

• Size on Disk
  Amount of disk space required after cluster allocation.

• Last Written
  Last written timestamp of the source file.

• Created
  Creation timestamp, if available.
  Shown in gray when Created Date is not selected.

• Last Accessed
  Last accessed timestamp, if available.
  Shown in gray when Last Accessed Date is not selected.

Files that are too large to fit in the image are shown in gray, are automatically unchecked, and cannot be selected.

---

Status Information

Totals are displayed in the status strip at the bottom of the dialog and update dynamically as files are selected or options change.

• Files Selected
  Number of files selected out of the total number of files in the list (shown as nn of nn).

• Bytes Required
  Total disk space required for the selected files.
  Displayed in red when the required space exceeds Bytes Free.

• Bytes Free
  Available free space in the destination image.

• Entries Required and Entries Free
  Displayed only when the destination directory cannot expand (for example, the root directory of a FAT12 floppy, which has a fixed entry count).
  Entries Required is shown in red when it exceeds Entries Free.

The Import button is automatically disabled when:

• No files are selected
• Bytes Required exceeds Bytes Free
• Entries Required exceeds Entries Free

---

Buttons

Import

• Imports all checked files using the chosen options
• Allocates clusters and directory entries as needed
• Applies the resolved Action (Add, Replace, or Rename) for each file
• Marks the image as modified

---

Cancel

• Closes the dialog without importing any files

---

Notes

• Imported files are added to the active image
• Filesystem limitations may affect available options (for example, long file names require FAT support for LFN entries)
• Cluster allocation may increase required disk space beyond file size
• Import operations are fully undoable
• The destination directory can be changed at any time before clicking Import