CardModel - класс

Модель карточки, доступная в UI.

Definition

Пространство имён: Tessa.UI.Cards
Сборка: Tessa.UI (в Tessa.UI.dll) Версия: 3.6.0.22

public sealed class CardModel : NotificationUIObject, 
	ICardModel, IFilePreviewInfoCacheProvider, IHtmlSanitizerProvider, IPreviewHandlersPoolProvider, IPreviewPageExtractorProvider, 
	ISealable, IUIContextExecutorProvider

Public NotInheritable Class CardModel
	Inherits NotificationUIObject
	Implements ICardModel, IFilePreviewInfoCacheProvider, IHtmlSanitizerProvider, IPreviewHandlersPoolProvider, 
	IPreviewPageExtractorProvider, ISealable, IUIContextExecutorProvider

C++

public ref class CardModel sealed : public NotificationUIObject, 
	ICardModel, IFilePreviewInfoCacheProvider, IHtmlSanitizerProvider, IPreviewHandlersPoolProvider, IPreviewPageExtractorProvider, 
	ISealable, IUIContextExecutorProvider

[<SealedAttribute>]
type CardModel = 
    class
        inherit NotificationUIObject
        interface ICardModel
        interface IFilePreviewInfoCacheProvider
        interface IHtmlSanitizerProvider
        interface IPreviewHandlersPoolProvider
        interface IPreviewPageExtractorProvider
        interface ISealable
        interface IUIContextExecutorProvider
    end

Inheritance: Object NotificationObject NotificationUIObject CardModel

Implements: ISealable, IPreviewHandlersPoolProvider, ICardModel, IFilePreviewInfoCacheProvider, IHtmlSanitizerProvider, IPreviewPageExtractorProvider, IUIContextExecutorProvider

Свойства

Binder	Вспомогательный класс, используемый для выполнения действий с карточкой, требующих наличие метаинформации.
BlockBag	Объект, содержащий неупорядоченный список всех блоков в карточке. При этом блоки карточки, её заданий и файлов размещаются в одном и том же объекте.
BlockInitializers	Список делегатов, выполняемых после инициализации каждого из блоков (моделей представления IBlockViewModel).
Blocks	Контейнер для блоков, доступных по имени.
Card	Информация о карточке.
CardCache	Кэш с карточками и дополнительными настройками.
CardMetadata	Метаинформация по типу карточки, которая описывается моделью, и связь между идентификаторами и именами секций и полей.
CardTask	Информация о задании, если модель соответствует карточке задания, или null в противном случае.
CardType	Ссылка на метаинформацию по типу карточки.
ClosingRequest	Последний запрос на сохранение карточки перед закрытием области с редактируемой карточкой, доступный только в расширениях на закрытие, или null, если сохранение ещё ни разу не выполнялось или проверяющий свойство код выполняется вне расширений на закрытие карточки. При установке значения свойства очистку этого значения должен выполнять тот же код, т.к. автоматического изменения значения не производится.
ContextIsInitialized	Признак того, что была выполнена инициализация контекста [Tessa.UI.IUIContext], связанная с текущей моделью карточки ICardModel.
ControlBag	Объект, содержащий неупорядоченный список всех элементов управления в карточке. При этом элементы управления карточки, её заданий и файлов размещаются в одном и том же объекте.
ControlCreationOverrides	Список делегатов для переопределения создания контрола. Если один из делегатов вернёт не null, то создания контрола стандартным способом не произойдёт и будет использован возвращённый контрол.
ControlInitializers	Список делегатов, выполняемых после инициализации каждого из элементов управления.
Controls	Контейнер для элементов управления, доступных по имени.
CurrentRow	Модель редактируемой строки, которая была открыта непосредственно из текущей модели (без учёта вложенных дочерних секций), или null, если в данный момент отсутствуют редактируемые строки.
Digest	Digest текущей карточки или null, если Digest неизвестен. Значение свойства может быть неактуальным, т.к. по умолчанию Digest может обновляться при обращении к сервису стандартными средствами.
EntryModel	Модель представления карточки, используемая для редактирования строковых секций. Это текущий объект, если он не используется для редактирования строки коллекционной или древовидной секции.
FileContainer	Контейнер с файлами карточки.
FileControlManager	Объект, управляющий областями предпросмотра файлов для всей карточки, т.е. для всех её вкладок.
FilePreviewManager	Объект, управляющий доступностью предпросмотра.
Flags	Флаги, описывающие особенности отображения карточки в UI.
FormBag	Объект, содержащий неупорядоченный список всех блоков в карточке. При этом блоки карточки, её заданий и файлов размещаются в одном и том же объекте.
FormInitializers	Список делегатов, выполняемых после инициализации каждого из форм (моделей представления IFormViewModel).
Forms	Формы, соответствующие вкладкам карточки.
GeneralMetadata	Общая метаинформация по всем типам карточек.
HasActiveValidation	Признак того, что во всех элементах управления следует включить активную валидацию. При этом элементы управления, для которых введены некорректные значения, будут уведомлять об этом рамкой валидации. Значение устанавливливается равным true обычно после неудачного сохранения карточки. По умолчанию значение равно false.
Info	Информация для расширений UI, связанная с моделью карточки, но отсутствующая в самой карточке. Сохраняемая информация может быть несериализуемой, например, можно записать ссылки на модели представлений или любые другие объекты.
IsClosed	Признак того, что все формы карточки [ICardModel.Forms] были закрыты.
IsHtmlSanitizingEnabled	Признак того, что санитайзинг HTML-документов разрешено выполнять.
IsSealed	Признак того, что объект был защищён от изменений.
LastRequest	Последний запрос на сохранение карточки или null, если сохранение ещё ни разу не выполнялось.
MainForm	Отображаемая форма карточки или текущая отображаемая форма задания.
MenuContext	Контекст, предоставляющий средства для генерации меню.
Notifications	Объект, управляющий отображением всплывающих уведомлений.
PageOptions	Настройки отображения области предпросмотра документа, разделённого на страницы. Значение не равно null.
ParentModel	Родительская модель представления карточки или null, если родительская модель отсутствует. По умолчанию значение отлично от null только для моделей представления, созданных для карточек заданий.
SectionRows	Пустые строки для коллекционных или древовидных секций карточки, доступные по имени секции.
Settings	Настройки модели представления карточки.
StateIsInitialized	Признак того, что состояние карточки уже было инициализировано, поэтому оно не будет перенесено автоматически из предыдущей открытой карточки в той же вкладке.
Table	Информация о строке коллекционной или древовидной секции карточки, редактирование которой выполняется в отдельной форме, или null, если редактируется основная карточка.
TableStack	Стек с информацией о строках коллекционных или древовидных секций карточки, редактирование которых выполняется в отдельной форме. По нулевому индексу доступна текущая редактируемая строка, по первому - её родительская строка и т.д. Если коллекция пуста, то редактирование строк не выполняется, т.е. редактируются строковые секции карточки.
TaskInitializers	Список делегатов, выполняемых после создания модели карточки каждого из заданий.
UIContextExecutorAsync	Делегат, выполняющий заданное действие в контексте [Tessa.UI.IUIContext].

Методы

CancelFileDownloading	Отменяет все асинхронные операции по скачиванию содержимого файлов. Обычно вызывается перед сохранением или обновлением карточки.
CloseAsync	Вызывает принудительное закрытие форм карточки [ICardModel.Forms]. Не выполняет действий, если формы уже были закрыты.
CommitChangesAsync	Подтверждает изменения для всех элементов управления, добавленных в [ICardModel.ControlBag]. Метод обычно вызывается перед сохранением карточки для того, чтобы элементы управления, у которых состояние ввода зависит от фокуса и других параметров, могли подтвердить введённое значение перед тем, как карточка будет сохранена. Метод возвращает результат выполнения для всех элементов управления. Если при выполнении методов у элементов управления возникли исключения, то они будут зафиксированы в результате.
CreateAsync	Создаёт экземпляр класса с указанием информации о карточке, коллекции пустых строк карточки для колекционных или древовидных секций с определёнными именами, и метаинформации о типе карточки.
CreateEmptyRow	Создаёт пустую строку для коллекционной или древовидной секции с заданным именем. Такая строка может использоваться для редактирования секции.
CreateForRow	Создаёт копию модели карточки для редактирования заданной строки коллекционной или древовидной секции.
Equals	Determines whether the specified object is equal to the current object. (Унаследован от Object)
ExecuteInContextAsync	Выполняет делегат в текущем контексте, который передаётся через параметр и через [Tessa.UI.UIContext.Current].
Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Унаследован от Object)
GetHashCode	Serves as the default hash function. (Унаследован от Object)
GetType	Gets the Type of the current instance. (Унаследован от Object)
HasChangesAsync	Проверяет наличие изменений в карточке и в контенте её файлов, которые доступны для сохранения.
InvokeStateInitializedAsync
MemberwiseClone	Creates a shallow copy of the current Object. (Унаследован от Object)
OnPropertyChanged(PropertyChangedEventArgs)	Уведомляет об изменении свойства с именем, заданным в аргументах события. (Унаследован от NotificationObject)
OnPropertyChanged(String)	Уведомляет об изменении свойства с заданным именем у объекта. (Унаследован от NotificationObject)
OnPropertyChangedAsync(PropertyChangedEventArgs, Boolean)	Уведомляет об изменении свойства с именем, заданным в аргументах события, асинхронно, в соответствии с принятым для текущего объекта поведением. Если есть возможность вызвать событие синхронно, то оно вызывается синхронно. Если объект является моделью представления WPF и текущий поток отличен от потока диспетчера WPF для приложения (основной поток UI), то выполнение асинхронно переключается в этот поток. Если это не так, то событие выполняется синхронно. (Унаследован от NotificationUIObject)
OnPropertyChangedAsync(String, Boolean)	Уведомляет об изменении свойства с заданным именем у объекта асинхронно, в соответствии с принятым для текущего объекта поведением. Если есть возможность вызвать событие синхронно, то оно вызывается синхронно. Если объект является моделью представления WPF и текущий поток отличен от потока диспетчера WPF для приложения (основной поток UI), то выполнение асинхронно переключается в этот поток. Если это не так, то событие выполняется синхронно. (Унаследован от NotificationObject)
RestoreFileDownloadingAfterCancel	Восстанавливает возможность выполнения асинхронных операций по скачиванию содержимого файлов после того, как была выполнена их отмена. Обычно вызывается после сохранения или обновления карточки.
SaveAsync	Выполняет сохранение карточки.
Seal	Защищает объект от изменений.
SetContextExecutor	Устанавливает делегат, выполняющий другой делегат в текущем контексте.
SetDigestAsync	Устанавливает Digest текущей карточки. Метод переносит выполнение на поток UI, если текущий поток отличается.
SetSavingFunc	Устанавливает функцию сохранения карточки.
ShowRowFormAsync	Отображает форму строки карточки из свойства [MainForm]. Текущий объект должен быть создан для строки карточки.
ToString	Returns a string that represents the current object. (Унаследован от Object)
TryGetHtmlSanitizer	Возвращает объект, выполняющий санитайзинг HTML-документов, или null, если такой объект не зарегистрирован или недоступен.
TryGetPageExtractor	Возвращает объект, выполняющий извлечение страницы для предпросмотра из многостраничного документа, или null, если такой объект не зарегистрирован или недоступен.
TryGetPreviewHandlersPool	Возвращает пул объектов для просмотра файлов или null, если такой объект не зарегистрирован или недоступен.
TryGetPreviewInfoCache	Возвращает кэш, предоставляющий информацию по предпросмотру файлов, или null, если кэш недоступен.

События

PropertyChanged	Событие, уведомляющее об изменении свойства с определённым именем у модели представления. (Унаследован от NotificationObject)
StateInitialized

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

Get	(Определяется ComHelper)
GetOrUpdateDigestAsync	Возвращает Digest карточки или вычисляет его, если он неизвестен, т.е. свойство Digest равно null. (Определяется CardUIExtensions)
InSpecialMode	Возвращает признак того, что в модели представления карточки установлен хотя бы один флаг из перечисления SpecialCardModelFlags, и это означает, что карточка открыта в специальном режиме, в котором необходимо включить или отключить некоторые функции. Например, карточка открыта как просмотр удалённой карточки или карточка создана из шаблона. (Определяется CardUIExtensions)
InternalMarkerCanvas	Возвращает маркер аннотации (Определяется AnnotationInternalsAccessor)
InvalidateTileVisibility	Сбрасывает кэш видимости плиток. Рекомендуется вызывать метод после изменения видимости плиток в карточке Card. (Определяется CardUIExtensions)
Invoke	(Определяется ComHelper)
ModifyOnStateInitializedAsync	Задает действие при инициализации состояния модели карточки, либо выполняет его немедленно, если состояние модели уже было инициализировано. (Определяется CardUIExtensions)
ModifyTasksAsync	Изменяет модели представлений для тех заданий карточки, которые либо присутствуют в UI в текущий момент, либо являются скрытыми и могут быть восстановлены (например, заданий автора). Возвращает признак того, что хотя бы одно задание присутствовало в карточке, возможно, как скрытое. (Определяется CardUIExtensions)
ModifyTopicsAsync	Изменяет модели представлений для тех топиков карточки, которые либо присутствуют в UI в текущий момент, либо добавятся позже, например, после отправки сообщения. Возвращает признак того, что хотя бы один топик присутствовал в карточке. (Определяется CardUIExtensions)
Set	(Определяется ComHelper)
SetActiveValidation	Устанавливает значение свойства HasActiveValidation для текущей и всех дочерних моделей ICardModel. При изменении значения свойства все элементы управления в списке ControlBag обновляют своё значение HasActiveValidation. (Определяется CardUIExtensions)
SetCardInTemplateType	Устанавливает тип карточки в шаблоне для редактируемой карточки шаблона. (Определяется CardUIExtensions)
SetPreviousPermissions	Устанавливает исходные разрешения для редактируемой карточки, которые были изменены для текущего редактирования. Например, это разрешения карточки в шаблоне. (Определяется CardUIExtensions)
SetTaskHistoryVisible	Показывает или скрывает вкладку с историей заданий, если она существовала при инициализации карточки (обычно это верно для всех типов карточек с флажком "Разрешить задания" AllowTasks). (Определяется CardUIExtensions)
SetTemplateCard	Устанавливает исходную карточку шаблона для редактируемой карточки. (Определяется CardUIExtensions)
SetTemplateOriginalCardID	Устанавливает идентификатор исходной карточки в шаблоне для редактируемой карточки. (Определяется CardUIExtensions)
SetTemplateSectionRows	Устанавливает исходную карточку шаблона для редактируемой карточки. (Определяется CardUIExtensions)
TileIsVisible	Возвращает признак того, что плитка с заданным именем должен быть видимым на основании данных в карточке, т.е. видимости, которая рассчитана в запросе на создание или загрузку карточки. Этот метод использует кэш для получения информации. При изменении информации в карточке рекомендуется вызвать метод InvalidateTileVisibility(ICardModel). (Определяется CardUIExtensions)
TryGetCardInTemplateType	Возвращает тип карточки в шаблоне для редактируемой карточки шаблона или null, если тип карточки в шаблоне не был установлен или были установлен как null. (Определяется CardUIExtensions)
TryGetMainForm	Возвращает основную форму карточки MainForm как интерфейс IMainFormViewModel или null, если у карточки отсутствует основная форма или если она не реализует интерфейс IMainFormViewModel. Форма может не реализовать этот интерфейс, если это форма задания, форма строки таблицы, форма диалога или другая форма, не имеющая вкладок. (Определяется CardUIExtensions)
TryGetPreviousPermissions	Возвращает исходные разрешения для редактируемой карточки, которые были изменены для текущего редактирования, или null, если разрешения не были установлены или были установлены как null. (Определяется CardUIExtensions)
TryGetTaskHistory	Возвращает модель представления для истории заданий, если в карточке присутствует вкладка "История заданий", или null в противном случае. (Определяется CardUIExtensions)
TryGetTaskItems	Возвращает коллекцию моделей представления для заданий, по которым можно модифицировать UI или модель заданий, или null, если в карточке отсутствуют доступные задания. (Определяется CardUIExtensions)
TryGetTemplateCard	Возвращает исходную карточку шаблона для редактируемой карточки или null, если исходная карточка не была установлена или была установлена как null. (Определяется CardUIExtensions)
TryGetTemplateOriginalCardID	Возвращает идентификатор исходной карточки в шаблоне для редактируемой карточки или null, если идентификатор не был установлен или был установлен как null. (Определяется CardUIExtensions)
TryGetTemplateSectionRows	Возвращает исходную карточку шаблона для редактируемой карточки или null, если исходная карточка не была установлена или была установлена как null. (Определяется CardUIExtensions)

См. также

Ссылки

Tessa.UI.Cards - пространство имён