Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Свойства

OnPathChosen

Ссылка на команду, выполняемую в момент выбора строки файла в списке файлов окна Диалог сохранения файла.

Корневой путь (RootPath)

Ограничивает область просмотра файловой системы. Тип значения – string.

Путь по умолчанию (DefaultPath)

Путь по умолчанию. Если указать значение, то при открытии окна Диалог сохранения файла всегда будет открыт указанный каталог. Тип значения – string.

Имя файла по умолчанию (DefaultFileName)

Имя файла по умолчанию. Значение свойства подставляется в поле Имя файла при открытии окна Диалог сохранения файла. Тип значения – string.

  • Если в значении указать расширение файла (например example.xml), значение будет подставлено в поле в исходном виде.
  • Если в значении не указывать расширение (например example), к значению будет добавлено расширение, выбранное из FileTypeFilter (Фильтр типа файлов).

Фильтр типа файлов (FileTypeFilter)

Фильтр отображаемого типа файлов. Тип значения – уведомляющий string.

Формат указания значения: Описание|расширение. Чтобы указать несколько типов, перечислите их через вертикальную черту (|).

  • Если указать значение, то в нижней части окна Диалог сохранения файла будет доступен выпадающий список – фильтр отображения файлов.

    Текстовый файл (*.csv)|*.csv

    Текстовый файл (*.csv)|*.csv|Книга Excel (*.xlsx)|*.xlsx|Файл Adobe PDF (*.pdf)|*.pdf

  • Если оставить значение свойства пустым, то при открытии окна будут отображаться все файлы и папки. Выпадающий список с фильтром будет недоступен.

Индекс типа в фильтре (DefaultFileType)

Устанавливает тип файлов по умолчанию в окне Диалог сохранения файла. Тип значения – int4.

Значение – номер записи типа в свойстве FileTypeFilter (Фильтр типа файлов) (нумерация ведется с 0).

Допустим, в качестве значения свойства FileTypeFilter (Фильтр типа файлов) указана строка:

Текстовый файл (*.csv)|*.csv|Книга Excel (*.xlsx)|*.xlsx

Тогда для DefaultFileType можно указать:

Показывать свойства файлов (ShowFileProperties)

Позволяет отображать больше информации о файлах в окне Диалог сохранения файла. Тип значения – уведомляющий bool.

Значение:

  • true – отображаются имена, даты изменения и размеры файлов (в байтах);

  • false – отображаются только имена файлов.

Разрешена смена папки (ChangeFolderAllowed)

Указывает на возможность смены папки, открывающейся в окне Диалог сохранения файла по умолчанию. Тип значения – уведомляющий bool.

Значение Результат
true – разрешено менять папку

В этом случае в окне Диалог сохранения файла отображается дерево каталогов и их содержимое (файлы и другие папки). Есть возможность перемещаться между каталогами и создавать новые папки.

false – запрещено менять папку

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

Разрешено создание папок (CreateFolderAllowed)

Указывает на возможность создания папок в окне Диалог сохранения файла. Тип значения – уведомляющий bool.

Значение:

  • true – разрешено создавать папки;
  • false – запрещено создавать папки.

Отображать панель просмотра (ShowBrowsePanel)

Ограничивает возможность просмотра иерархии папок и уменьшает размеры диалога. Тип значения – уведомляющий bool.

Значение:

  • true – просмотр иерархии папок разрешен;
  • false – просмотр иерархии папок запрещен.

Внешний вид окна, если значение свойства – false:

Ссылка на результат (Result)

Ссылка на экземпляр типа Результат выбора файла, в котором будет сохранено имя и тип сохраняемого файла.

Отображать кнопку Параметры (EditSettingsAllowed)

Меняет видимость кнопки Параметры в окне Диалог сохранения файла. Тип значения – уведомляющий bool.

Значение:

  • true – кнопка есть;
  • false – кнопки нет.

При нажатии на кнопку активируется команда OnEditSettings.

OnEditSettings

Ссылка на команду, выполняемую при нажатии на кнопку Параметры в окне Диалог сохранения файла.

Видимость кнопки зависит от значения свойства EditSettingsAllowed (Отображать кнопку Параметры).

OnComplete

Ссылка на команду, выполняемую в результате нажатия кнопки Сохранить и закрытии окна Диалог сохранения файла.

Вызов экранной клавиатуры (init_ScreenKeyboard)

Ссылка на экземпляр типа Параметры вызова экранной клавиатуры, хранящий настройки вызова экранной клавиатуры.

Родительский компонент (pParent)

Ссылка на родительский компонент типа Прямоугольник. Используется для того, чтобы диалоговое окно открывалось по центру родительского компонента.