IFileControl - интерфейс

Объект, создающий элементы меню для заданных действий [Tessa.UI.Menu.IMenuAction].

Коллекция действий, связанных с элементом управления файлами.

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

Контейнер, содержащий все доступные файлы. Не равен null. Значение свойства можно изменить, чтобы привязать элемент управления к другому контейнеру.

Коллекция действий, связанных с файлами внутри элемента управления файлами.

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

Коллекция группировок файлов, которая может быть выбрана с элементе управления.

Признак того, что группы развёрнуты по умолчанию.

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

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

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

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

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

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

Признак того, что объект был выгружен и уже не может использоваться в UI. Например, если объект является контролом карточки, то он становится выгруженным после закрытия формы редактирования строки или пре рефреше карточки.

Фильтр, принимающий модель представления файла и возвращающий true, если файл должен отображаться пользователю, или false в противном случае. Функция вызывается только для тех моделей представления, которые не скрыты по другим условиям (таким как фильтрация через контекстное меню контрола), что позволяет дополнительно скрывать файлы по условию, но не показывать файлы, которые были скрыты по другим причинам. Если значение равно null (по умолчанию), то отображаются все файлы, которые могут быть отображены в соответствии с текущими настройками. После изменения свойства рекомендуется вызвать метод [IFileControl.RefreshItemFilteringAsync] для того, чтобы фильтр был применён к текущим отображаемым файлам.

Коллекция моделей представления для файлов, отображаемых в элементе управления. Связана с коллекцией [IFileControl.Files].

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

Контекст, предоставляющий средства для генерации меню.

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

Имя элемента управления с областью предпросмотра или null, если используется область предпросмотра по умолчанию.

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

Используемая фильтрация файлов. Отфильтрованные файлы не отображаются.

Выбранная группировка файлов или null, если группировка ещё не выбрана. По умолчанию значение null.

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

Выбранное направление сортировки. По умолчанию выбрана сортировка по возрастанию.

Выбранная сортировка файлов или null, если сортировка ещё не выбрана. По умолчанию значение null.

Коллекция сортировок файлов, которая может быть выбрана с элементе управления.

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

Коллекция действий, связанных с версиями файлов внутри элемента управления файлами.

Снимает выделение со всех файлов в элементе управления.

Выполняет делегат в текущем контексте, который передаётся через параметр и через [Tessa.UI.UIContext.Current].

Выполняет инициализацию элемента управления в момент завершения его инициализации и инициализации других объектов, в т.ч. других элементов управления в карточке. При этом могут выполняться расширения.

Генерирует контекстное меню для элемента управления. При этом могут выполняться расширения. Возвращает пункты контекстного меню и подготовленные группировки и сортировки, актуальные в текущий момент.

Генерирует контекстное меню для заданного файла. При этом могут выполняться расширения. Возвращает пункты контекстного меню.

Генерирует контекстное меню для заданной версии файла. При этом могут выполняться расширения. Возвращает пункты контекстного меню.

Возвращает текущее состояние элемента управления.

Выполняет инициализацию элемента управления. При этом могут выполняться расширения.

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

Обновляет список элементов управления, которые отображаются на экране. Вызовите метод после установки фильтра [IFileControl.ItemFilter] для его применения ко всем файлам. В противном случае он применяется только при изменении коллекции или при перерисовке списка элементов на экране. Может быть вызван не из потока UI.

Выбирает фильтрацию файлов.

Выбирает группировку файлов.

Выбирает сортировку вместе с её направлением.

Устанавливает заданное состояние для элемента управления.

Выполняет выгрузку объекта. Если объект уже был выгружен, то повторная выгрузка не выполняется.

Событие, возникающее после выполненного добавления файла в элемент управления в связи с тем, что файл был добавлен в контейнер [IFileControl.Container]. Если событие [IFileControlNotificationSource.ContainerFileAdding] было отменено, то файл добавлен не был, и это событие не выполняется.

Событие, возникающее перед добавлением файла в элемент управления в связи с тем, что файл был добавлен в контейнер [IFileControl.Container].

Событие, возникающее после выполненного удаления файла из элемента управления в связи с тем, что файл был удалён из контейнера [IFileControl.Container]. Если событие [IFileControlNotificationSource.ContainerFileRemoving] было отменено, то файл удалён не был, и это событие не выполняется.

Событие, возникающее перед удалением файла из элемента управления в связи с тем, что файл был удалён из контейнера [IFileControl.Container].

Occurs when a property value changes.

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

Устанавливает метод, определяющий параметры предпросмотра файла с конвертацией. Метод вызывается при предпросмотре файлов, у которых ещё не выполнена конвертация, т.е. не установлен отдельный объект PreviewContent, но при этом текущее содержимое [!:IFile.Content] не отмечено, как изменённое IsDirty. Если файл был открыт на редактирование (отображается жёлтым), то стандартный предпросмотр для него отключён.

Устанавливает метод, определяющий параметры файла, добавляемого специальным образом. Метод вызывается при добавлении файлов в специальных случаях, таких как создание файла по шаблону и сохранение многостраничного документа из окна сканирования. Метод не вызывается при типовой загрузке файлов через меню контрола или буфер обмена.

Устанавливает метод, определяющий параметры файла, добавляемого по заданному пути на диске. Метод вызывается при добавлении файлов в типовых сценариях (функция "Загрузить файлы", вставка из буфера обмена, drag&drop). Для специальных случаев, таких как создание файла по шаблону или добавление из окна сканирования, используйте методы SetNewFileAction.

Возвращает метод, определяющий параметры предпросмотра файла с конвертацией, или null, если такой метод отсутствует. Метод должен быть выполнен с указанием текущего контекста Current. Метод вызывается при предпросмотре файлов, у которых ещё не выполнена конвертация, т.е. не установлен отдельный объект PreviewContent, но при этом текущее содержимое [!:IFile.Content] не отмечено, как изменённое IsDirty. Если файл был открыт на редактирование (отображается жёлтым), то стандартный предпросмотр для него отключён.

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

Возвращает метод, определяющий параметры файла, добавляемого по заданному пути на диске, или null, если такой метод отсутствует. Метод должен быть выполнен с указанием текущего контекста Current. Метод вызывается при добавлении файлов в типовых сценариях (функция "Загрузить файлы", вставка из буфера обмена, drag&drop). Для специальных случаев, таких как создание файла по шаблону или добавление из окна сканирования, используйте методы TryGetNewFileAction.

Выполняет выгрузку объекта. Если объект уже был выгружен, то повторная выгрузка не выполняется. Возвращает объект, содержащий сообщения, возникшие в процессе выгрузки, в т.ч. ошибки.