Dialog.FileBrowse

(логический) Делать ли диалоговое окно диалогом "Открыть файл":

ЗНАЧЕНИЕ VALUE	ОПИСАНИЕ DESCRIPTION
true	Диалоговое окно будет диалогом "Открыть файл".
false	Диалоговое окно будет диалогом "Сохранить файл".

(строка) Текст, показываемый в заголовке диалогового окна.

(строка) Папка для просмотра по умолчанию.

(строка) Фильтры типа файла, которые будут использоваться при просмотре. По умолчанию "Все файлы (*.*)|*.*| (All Files (*.*)|*.*|)". Эти элементы управления фильтрами типов файлов будет видно в диалоговом окне просмотра файлов. Например, если нужно отфильтровать только исполняемые файлы, можно поставить "Executables (*.exe)|*.exe|". "Executables (*.exe)" это описание, что будет показано в поле "Files of type" диалогового окна и может быть любым нужным текстом. "|*.exe|" означает фильтр файлов, который будет использоваться внутри программы. Также можно включить несколько фильтров для выбора. Например, "Executables (*.exe)|*.exe|Text Files (*.txt)|*.txt|". Второй фильтр в диалоговом окне будет доступен из выпадающего списка в поле "Files of type". Также есть возможность указать более чем один шаблон для фильтра, разделяя их точкой с запятой. Например, "Pictures (.png, .jpg, .tif)|*.png;*.jpg;*.tif|".

(строка) Имя файла, что будет изначально появляться в поле редактирования имени файла.

(строка) Расширение файла по умолчанию. Оно будет добавлено к имени файла в поле редактирования имени файла, если пользователь не задал расширение.

(логический) Разрешить ли множественный выбор файлов:

ЗНАЧЕНИЕ VALUE	ОПИСАНИЕ DESCRIPTION
true	Разрешает множественный выбор.
false	Не разрешает. (По умолчанию)

(логический) Проверять ли существование имени файла в поле редактирования диалогового окна, когда пользователь кликает кнопки "Открыть (Open)" или "Сохранить (Save)".

ЗНАЧЕНИЕ VALUE	ОПИСАНИЕ DESCRIPTION
true	Файл должен быть.
false	Файла может не быть. (По умолчанию)

(таблица) Таблица, содержащая список путей к файлам, которые выбраны. Каждый отдельный путь может быть доступен по его табличному указателю (индексу). Если пользователь отменил операцию (нажал на кнопку отмена - cancel), будет возвращена строка "CANCEL" в таблице (tb[1] = "CANCEL"). Если происходит ошибка, будет возвращено значение nil. Можно использовать Application.GetLastError для определения случился ли отказ в работе этого действия и почему.

При добавлении действия из редактора скрипта, можно использовать это поле для определения переменной, которая возвращает значение, сохраняющееся в ней.

files = Dialog.FileBrowse(true, "Open File", _ProgramFilesFolder, "Text File (*.txt)|*.txt|All Files(*.*)|*.*|", "", "", false, false);

Пользователю предлагается выбрать одиночный текстовый файл из его папки Program Files и сохраняет его в таблице с именем "files."

-- Display a single-selection file browse dialog
-- Показываем диалоговое окно просмотра файла для одиночного выбора
result = Dialog.FileBrowse(true, "Load File", _DesktopFolder, "Microsoft Word Document (*.doc)|*.doc|All Files (*.*)|*.*|", "", "", false, true);

-- If CANCEL was not chosen, then let's get the file path
-- Если ОТМЕНА не выбрана, получаем путь к файлу
if (result[1] ~= "CANCEL") then
    Dialog.Message("You chose the following file", result[1]);
end

Предлагаем пользователю выбрать одиночный файл документа Word (.doc), при просмотре папки его Рабочего стола (Desktop), и сохраняем путь к файлу, им выбранному, в таблице с именем "result." Если кнопка отмена (cancel) не была нажата, показываем диалоговое окно сообщения, с путем к файлу, что сохранен в таблице.

-- Prompt the user to select files to add to the zip archive.
-- Предлагаем пользователю выбрать файлы для добавления к zip архиву.
archive_files = Dialog.FileBrowse(true, "Files to Add", _DesktopFolder, "All Files (*.*)|*.*|", "", "dat", true, false);

-- Check to see if an error occurred, or the user cancelled.
-- Смотрим, не произошла ли ошибка, или не отменил ли действие пользователь.
if (archive_files[1] ~= "CANCEL") and (archive_files ~= nil) then

    -- Show the status dialog.
    -- Показываем диалоговое окно состояния.
    StatusDlg.Show();

    -- Add the chosen files to the zip archive.
    -- Добавляем выбранные файлы к zip архиву.
    Zip.Add(_DesktopFolder .. "\\NewArchive.zip", archive_files, true, "", 5, nil, false);

    -- Get the error code of the zip.add action.
    -- Получаем код ошибки от действия zip.add.
    error = Application.GetLastError();

    -- Hide the status dialog.
    -- Скрываем диалоговое окно состояния.
    StatusDlg.Hide();

    -- If it succeeded, display a success message and open the folder. Otherwise display the error message.
    -- Если цель достигнута, показываем сообщение об успехе и открываем папку. В противном случае показываем сообщение об ошибке.
    if (error == 0) then
        Dialog.Message("Success", "The files were successfully archived.", MB_OK, MB_ICONINFORMATION);

        -- Open the folder where the zip file was created.
        -- Открываем папку, где был создан zip файл.
        File.ExploreFolder(_DesktopFolder, SW_SHOWNORMAL);
    else
        Dialog.Message("Error", _tblErrorMessages[error], MB_OK, MB_ICONEXCLAMATION);
    end
end

Отображается диалоговое окно просмотра файла, позволяя пользователю выбрать файлы, которые нужно добавить к Zip архиву. Выбранные файлы затем добавляются к Zip архиву, созданному на Рабочем столе пользователя. Если процесс завершился благополучно, показываем сообщение об успехе. Если же произошла ошибка, показываем сообщение с кодом ошибки.