Таблица

Иерархия типа

graph TD;
Таблица["Таблица"]-->Список["Список"];
Список["Список"]-->Компонент["Компонент"];
Компонент["Компонент"]-->Объект["Объект"];

Компонент для вывода набора записей в виде таблицы.

• SourceType - Тип источника данных списка

Особенности редактирования в таблице

Доступность редактирования определяется свойствами Доступность и ТолькоЧтение у самой таблицы. Данные разрешено редактировать если Доступность == Истина И ТолькоЧтение == Ложь. У каждой конкретной колонки таблицы можно выключить редактирование, аналогичными свойствами Доступность и ТолькоЧтение

Особенности привязки данных в таблице

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

• ДанныеСтроки(RowData): SourceType.DataType - данные строки таблицы.

Пример:

Тип: СтандартнаяКолонкаТаблицы<ДанныеСтрокиТаблицыТоваров>
Представление: =ДанныеСтроки.Представление
ЦветФонаЗначка: =ЦветФонаЗначка(ДанныеСтроки)

Особенности обработчиков событий в таблице

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

Пример: у компонента [Надпись] есть событие [Надпись.ПриНажатии], его обработчик на форме выглядит так:

метод ПриНажатииНаНадпись(Ссылка: Строка | Сущность.Ссылка)
   Сообщить("ПриНажатии")
;

Но при размещении этой надписи в произвольной колонке таблицы, обработчик будет выглядеть так:

метод ПриНажатииНаНадпись(Ссылка: Строка | Сущность.Ссылка, ДанныеСтроки: SourceType.DataType)
   Сообщить("ПриНажатии")
;

Особенности управления колонками в таблице

Колонки в таблице ведут себя по-разному, в зависимости от установленного таблице свойства [.РастягиватьПоГоризонали].

Если растягивание установлено в [.Растягивать] - колонки, будут стараться уместиться на всю доступную ширину видимой области таблицы.

Если растягивание установлено в [.НеРастягивать] - ширина таблицы будет зависеть от содержимого колонок, их размеров и заданные условия ширины самой таблицы.

Особенности поиска по таблице

Свойство [ИспользованиеПоиска] в значении [.НеИспользовать] игнорируется если свойство [ПоказыватьНастройки] = Истина

Сравнение ссылочное

Конструкторы

Таблица

Таблица(
  Видимость: Булево,
  Доступность: Булево,
  ТолькоЧтение: Булево,
  ВыравниваниеВГруппеПоВертикали: ВыравниваниеПоВертикали,
  ВыравниваниеВГруппеПоГоризонтали: ВыравниваниеПоГоризонтали,
  ВесПриРастягивании: Число,
  Высота: Число,
  Ширина: Число,
  ШиринаВКолонках: ШиринаВКолонках,
  МаксимальнаяВысота: Число,
  МаксимальнаяШирина: Число,
  МинимальнаяВысота: Число,
  МинимальнаяШирина: Число,
  РастягиватьПоВертикали: РастягиваниеКомпонента,
  РастягиватьПоГоризонтали: РастягиваниеКомпонента,
  ПослеСоздания: ()->ничто,
  ПриПеретаскивании: (Компонент, СобытиеПриПеретаскивании)->ничто,
  Источник: SourceType,
  Навигация: ВидНавигацииВСписке,
  АвтоВыделениеСтроки: АвтоВыделениеСтроки,
  ИспользоватьВыделениеСтроки: Булево,
  КомандыСтроки: ФрагментКомандногоИнтерфейса<КомандаСПараметром<SourceType.IdType>|КомандаСПараметром<Массив<SourceType.IdType>>>?, КомандыНадОтмеченнымиСтроками: ФрагментКомандногоИнтерфейса<КомандаСПараметром<Массив<SourceType.IdType>>>?, Удалить: КомандаСПараметром<Массив<SourceType.IdType>>, ОтображатьПанельКомандНадОтмеченнымиСтроками: Булево, ИспользованиеПоиска: ИспользованиеПоискаВСписке, ОтображениеПоляПоиска: ВидОтображенияПоляПоискаВСписке, ПодсказкаПоляПоиска: Строка, ПредставлениеОтмеченнойСтроки: Строка?, РазмерСтраницы: Число, ИспользоватьОтметкиСтрок: Булево, Команды: ФрагментКомандногоИнтерфейса<Команда>?, ПослеСозданияСтроки: (Список<SourceType>, СобытиеСДанными<СтрокаСписка<SourceType.DataType>>)->ничто, ПриНажатииСтроки: (Список<SourceType>, СобытиеСДанными<СтрокаСписка<SourceType.DataType>>)->ничто, ПриВыделенииСтроки: (Список<SourceType>, СобытиеСДанными<SourceType.IdType?>)->ничто, Заголовок: Строка, ВидОтображения: ВидОтображенияТаблицы, МаксимальнаяВысотаСтроки: Число, ПрокруткаПоВертикали: Булево, ВидОтображенияКомандСтроки: ВидОтображения, ОтображаемоеКоличествоКомандСтроки: Число, ОтображатьШапку: Булево, ПоказыватьНастройки: Булево, ИспользоватьРасширенныеНастройки: Булево, ДобавитьСтроку: Команда|ГруппаКомандногоИнтерфейса<Команда>, ПереместитьСтрокуВверх: Команда, ПереместитьСтрокуВниз: Команда, Колонки: Массив<КолонкаТаблицы<SourceType.DataType>>, ПриЧтенииНастроекТаблицы: (Таблица<SourceType>, СобытиеСДанными<Массив<СохраненнаяНастройкаТаблицы>>)->ничто, ПриСохраненииНастроекТаблицы: (Таблица<SourceType>, СобытиеСДанными<Массив<СохраненнаяНастройкаТаблицы>>)->ничто)

Свойства

ВидОтображения

Задаёт вид отображения данных таблицы.

ВидОтображенияКомандСтроки

Задаёт вид отображения панели команд строки. При [.Авто] ориентируется на свойство [РастягиватьПоГоризонтали] - при [Растягивать] использует [Всегда], иначе [ПриНаведении]

ДобавитьСтроку

Встроенная команда добавления новой строки.

Заголовок

Заголовок таблицы. Если указано - будет использован соответствующий заголовок. Если не указано - будет использовано название справочника в случае использования [ДинамическогоСписка], как [.Источника]. Иначе - значение по умолчанию.

ИспользоватьРасширенныеНастройки

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

Колонки

Описания колонок таблицы.

МаксимальнаяВысотаСтроки

Задаёт максимальную высоту строки в строках текста. Применяется, когда [.Вид] = Текст. 0 - не ограничено.

ОтображаемоеКоличествоКомандСтроки

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

ОтображатьШапку

Включает или выключает отображение заголовка таблицы.

ПереместитьСтрокуВверх

Встроенная команда перемещения строк вверх.

ПереместитьСтрокуВниз

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

ПоказыватьНастройки

При использовании данного флага в значении Истина, у Таблицы для Пользователя включится механизм настройки в случае, если [.Источник] - ДинамическийСписок.

Механизм настройки включает в себя два вида: простые и продвинутые. Пользователь сможет переключаться между ними самостоятельно. Изначальный вид зависит от флага ИспользоватьРасширенныеНастройки и состава предопределенных (описанных Разработчиком отборов у Источника) или сохраненных настроек таблицы.

ПриСохраненииНастроекТаблицы

Событие, вызываемое при задействовании Пользователем механизма настроек таблицы. Содержит в массиве все известные настройки Таблицы в рамках сеанса Пользователя. Вызывается:

• при сохранении Пользователем новой настройки
• при обновлении Пользователем существующей настройки
• при удалении Пользователем настройки

ПриЧтенииНастроекТаблицы

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

ПрокруткаПоВертикали

При значении Истина таблица будет использовать вертикальную прокрутку содержимого

Список унаследованных методов

Объект

Список

Список унаследованных свойств

Список