GridViewModel - свойства

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

Кнопка добавления строки. Нельзя присвоить значение null. Видимость кнопки устанавливается автоматически, не рекомендуется его изменять без необходимости.

Признак того, что в таблице включено автоопределение размера столбцов.

Максимальное количество строк, при которых контрол функционирует в режиме автоопределения размера столбцов. Если строк становится больше заданного количества, то AutoSize устанавливается равным false. Если задано -1, то автоопределение размера столбцов всегда выключено (даже когда ноль строк), а если int.MaxValue - то всегда включено. Изменение этого свойства не изменяет автоматически свойство AutoSize, для этого используйте метод UpdateAutoSizeFromRowLimit. Также свойство автоматически обновляется при добавлении строк средствами контрола (AutoSize может быть установлен равным false, если он был равен true и не выполняется условие по AutoSizeRowLimit).

Блок, в котором размещён текущий элемент управления.

Признак того, что пользователь может сортировать таблицу по колонкам, кликая по их заголовкам.

Заголовок элемента управления.

Стиль текста для заголовка контрола.

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

Информация о типе отображаемого элемента управления.

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

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

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

Список методов, выполняющих построение контекстного меню для строк таблицы.

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

Кнопка удаления выделенных строк. Нельзя присвоить значение null. Видимость кнопки устанавливается автоматически, не рекомендуется его изменять без необходимости.

Команда, выполняемая при открытии окна редактирования строки (например, по двойному клику). Команду нельзя изменить в расширениях, используйте событие RowInvoked.

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

Сообщение об ошибке, связанное с текущим объектом, или null, если ошибки нет.

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

Признак того, что элемент управления получит логический фокус, как только элемент управления станет доступен, т.е. его свойство [Tessa.UI.Cards.IControlViewModel.IsEnabled] будет равно true.

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

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

Признак того, что форма уже инициализирована вызовом InitializeAsync(CancellationToken), поэтому повторные вызовы метода будут игнорироваться.

Признак того, что элемент управления не содержит отображаемых данных.

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

Признак того, что элемент управления имеет логический фокус. Проверка и установка значения свойства имеет смысл только в случае, если элемент управления может получить логический фокус, т.е. значение свойства [Tessa.UI.Cards.IControlViewModel.Focusable] равно true.

Признак того, что элемент управления доступен только для чтения или не содержит редактируемых данных. Для контрола "Кнопка" разрешает или запрещает нажатие по кнопке.

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

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

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

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

Сообщение об ошибке, связанное со свойством текущего объекта, или null, если ошибки нет.

Список методов, выполняющихся при обработке нажатия клавиши.

Дополнительные кнопки под таблицей слева.

Заданный в настройках отступ элемента управления относительно других элементов управления. По умолчанию отступ отсутствует. Если по одному из направлений (слева, сверху и пр.) задано отрицательное значение, то по этому направлению отступ не отображается (т.е. равен 0).

Максимальная высота контрола. Укажите null, если высота должна быть неограничена.

Максимальная ширина контрола. По умолчанию значение равно double.PositiveInfinity. Значение не может быть меньше 0. При установке значения 0 в действительности устанавливается double.PositiveInfinity, т.к. в настройках контрола 0 эквивалентно отсутствию ограничения на контрол.

Минимальная ширина контрола. По умолчанию значение равно 0 и не может быть меньше.

Модель для текущей модели представления.

Команда, выполняемая при перемещении выбранных строк таблицы вниз на одну строку. Команду нельзя изменить в расширениях.

Команда, выполняемая при перемещении выбранных строк таблицы вверх на одну строку. Команду нельзя изменить в расширениях.

Видимость для кнопок перемещения строк вверх/вниз. Свойство устанавливается автоматически, не рекомендуется его изменять без необходимости.

Имя элемента управления, по которому он доступен в коллекции, или null, если у элемента управления не задано имя.

Текст валидации обязательного для заполнения элемента.

Дополнительные кнопки под таблицей справа.

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

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

Видимость для поля поиска SearchText. Свойство устанавливается автоматически, не рекомендуется его изменять без необходимости.

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

Выбранная строка. Чтобы изменить выбранную строку, достаточно присвоить объект строки в этом свойстве, при этом такой объект CardRowViewModel должен содержаться в списке строк Rows.

Коллекция выбранных строк. Не рекомендуется изменять список строк через это свойство. Используйте свойство IsSelected в объекте CardRowViewModel, чтобы выбрать несколько строк или снять выделение.

Способ выбора строк в таблице. Позволяет включить или отключить множественный выбор строк в таблице.

Признак того, что текущий контрол в блоке всегда начинается с новой строки.

Всплывающая подсказка для элемента управления или null, если подсказка отсутствует. Пустая строка или строка, состоящая из пробелов, присваивается как null.

Функция валидации, проверяющая элемент управления на корректность его значения, или null, если дополнительные проверки значения отсутствуют. Проверка на незаполненное значение всё равно выполняется, если элемент управления был отмечен как обязательный для заполнения (в т.ч. посредством валидатора). Для использования функции на элементе управления должна быть включена валидация [Tessa.UI.Cards.IControlViewModel.HasActiveValidation].

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