getPathsByDialog

await crafttechApi.getPathsByDialog(type, isMultiple, isWarn);

Описание

Открывает диалоговое окно в Проводнике и возвращает абсолютные пути до файлов, выбранных пользователем в этом окне.

Параметры

• type (string) — тип поддерживаемых файлов в строковом формате:
  • any — все типы файлов;
  • cell — электронные таблицы;
  • word — электронные документы;
  • images — изображения;
  • video — видеофайлы;
  • audio — аудиофайлы;
  • plugin — плагины;
  • Также можно указать конкретный тип файла, который будет возможен для выбора. Для этого перед расширением файла нужно указать символ ”＊” и обернуть маску скобками. Например .getPathsByDialog(”(＊.xlsx)”).
• isMultiple (boolean) — флаг, указывающий, можно ли выбирать несколько файлов в Проводнике.
• isWarn (boolean) — флаг, указывающий, будет ли макрос выдавать ошибку и останавливать выполнение кода, если файл не выбран (возвращать reject(false)). По умолчанию стоит true (для корректной работы старых макросов).

Возвращает

• filePaths (string[] | null) — массив строк с абсолютными путями до выбранных файлов, null - если установлен флаг isWarn как false и не выбраны файлы.

Пример

const files = await crafttechApi.getPathsByDialog("any", true);
for (let i = 0; i < files.length; i++) {
  const handler = await crafttechApi.openFile_debug(files[i]);
  console.log(`id файла с абсолютным путём ${files[i]}: ${handler}`);
  await crafttechApi.closeFile_debug();
}

Код выше откроет окно проводника, в котором пользователь выбирает файлы, которые хочет открыть. После выбора файлов метод вернёт массив с абсолютными путями до выбранных файлов.