uiGetFiles#

pyCGM2.Tools.uiTools.uiGetFiles(title: str = 'Select Files', start_dir: str = '', filetypes: list[tuple[str, str]] | None = None) → list[str] | None#

Open a dialog to select one or several files.

Parameters:
  • title (str, optional) – Dialog title. Defaults to "Select Files".

  • start_dir (str, optional) – Initial folder.

  • filetypes (list, optional) – List of (description, pattern) tuples, e.g. [("CSV files", "*.csv"), ("All files", "*.*")].

Returns:

Optional[List[str]] – Selected file paths (with backslashes), or None if cancelled.

Example:

files = uiTools.uiGetFiles(
    title="Select the clinical examination file",
    start_dir=sessionPath + oldReportFolder,
    filetypes=[("CSV files", "*.csv"), ("Excel files", "*.xlsx"), ("All files", "*.*")])
filename = files[0] if files else None