IFileContainer - интерфейс

Контейнер, содержащий все доступные файлы.

Definition

Пространство имён: Tessa.Files
Сборка: Tessa (в Tessa.dll) Версия: 4.0.4
C#
public interface IFileContainer : INotifyPropertyChanged
Implements
INotifyPropertyChanged

Заметки

Реализация INotifyPropertyChanged требуется для того, чтобы не возникало утечек памяти при взаимодействии с UI.

Свойства

Files Коллекция файлов, доступных в контейнере.
Info Дополнительная информация по объекту, доступная для установки в расширениях. Сохраняемая информация может быть несериализуемой, например, можно записать ссылки на модели представлений или любые другие объекты.
Permissions Разрешения, доступные для контейнера с файлами.
Source Источник файлов, обеспечивающий способ их создания по умолчанию.

События

PropertyChangedOccurs when a property value changes.
(Унаследован от INotifyPropertyChanged)

Методы расширения

AddVirtualAsync Создаёт и добавляет виртуальный файл, возвращает созданный файл. Этот метод добавляет файл в источник по умолчанию Source для контейнера container.
(Определяется FileExtensions)
AddVirtualAsync Создаёт и добавляет виртуальный файл, возвращает созданный файл. Этот метод добавляет файл в указанный источник fileSource, что позволяет, например, добавить файл в структуру карточки CardFile, с которой не связан контейнер файлов container.
(Определяется FileExtensions)
BuildFile

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

По умолчанию файл создаётся с использованием источника Source, заданного в контейнере.

На возвращаемом объекте IFileBuilder необходимо вызвать один из методов установки контента SetContent.


(Определяется FileExtensions)
SetFilePreviewAction Устанавливает метод, определяющий параметры предпросмотра файла с конвертацией. Метод вызывается при предпросмотре файлов, у которых ещё не выполнена конвертация, т.е. не установлен отдельный объект PreviewContent, но при этом текущее содержимое [!:IFile.Content] не отмечено, как изменённое IsDirty. Если файл был открыт на редактирование (отображается жёлтым), то стандартный предпросмотр для него отключён.
(Определяется FileUIExtensions)
SetNewFileAction Устанавливает метод, определяющий параметры файла, добавляемого специальным образом. Метод вызывается при добавлении файлов в специальных случаях, таких как создание файла по шаблону и сохранение многостраничного документа из окна сканирования. Метод не вызывается при типовой загрузке файлов через меню контрола или буфер обмена.
(Определяется FileUIExtensions)
SetNewPhysicalFileAction Устанавливает метод, определяющий параметры файла, добавляемого по заданному пути на диске. Метод вызывается при добавлении файлов в типовых сценариях (функция "Загрузить файлы", вставка из буфера обмена, drag&drop). Для специальных случаев, таких как создание файла по шаблону или добавление из окна сканирования, используйте методы SetNewFileAction.
(Определяется FileUIExtensions)
TryGetFile Возвращает файл, полученный по заданному идентификатору ID, или null, если подходящий файл не был найден.
(Определяется FileExtensions)
TryGetFile Возвращает файл, полученный по заданному имени Name, или null, если подходящий файл не был найден.
(Определяется FileExtensions)
TryGetFilePreviewAction Возвращает метод, определяющий параметры предпросмотра файла с конвертацией, или null, если такой метод отсутствует. Метод должен быть выполнен с указанием текущего контекста Current. Метод вызывается при предпросмотре файлов, у которых ещё не выполнена конвертация, т.е. не установлен отдельный объект PreviewContent, но при этом текущее содержимое [!:IFile.Content] не отмечено, как изменённое IsDirty. Если файл был открыт на редактирование (отображается жёлтым), то стандартный предпросмотр для него отключён.
(Определяется FileUIExtensions)
TryGetNewFileAction Возвращает метод, определяющий параметры файла, добавляемого специальным образом, или null, если такой метод отсутствует. Метод должен быть выполнен с указанием текущего контекста Current. Метод вызывается при добавлении файлов в специальных случаях, таких как создание файла по шаблону и сохранение многостраничного документа из окна сканирования. Метод не вызывается при типовой загрузке файлов через меню контрола или буфер обмена.
(Определяется FileUIExtensions)
TryGetNewPhysicalFileAction Возвращает метод, определяющий параметры файла, добавляемого по заданному пути на диске, или null, если такой метод отсутствует. Метод должен быть выполнен с указанием текущего контекста Current. Метод вызывается при добавлении файлов в типовых сценариях (функция "Загрузить файлы", вставка из буфера обмена, drag&drop). Для специальных случаев, таких как создание файла по шаблону или добавление из окна сканирования, используйте методы TryGetNewFileAction.
(Определяется FileUIExtensions)

См. также