PFSGrid. Версия 1.0 (стр. 5 )

Общие

PFS. GUI. Controls. PFSGrid.LineStyles	Класс – описание вариантов для динамического свойства, описывающего стили линий. Этот класс необходим для определения содержимого выпадающего списка редактирования стиля линии. По умолчанию в динамическом свойстве устанавливается класс, описывающий стандартное перечисление Framework
Предопределенные значения
Название	Описание
LineStyles Standard	Описание встроенных в. NET Framework стилей линий
Свойство
Название	Описание
String[] Names	Массив имен стилей линий.
DashStyles[] Style	Стиль отображения.

PFS. GUI. Controls. PFSGrid.PFSImageItem	Класс – описание пиктограммы для ячейки выбора рисунка. При клонировании динамического свойства этот элемент не клонируется для нового экземпляра, а происходит простая передача ссылки.
Свойство
Название	Описание
String Name	Название пиктограммы
Image Style	Пиктограмма
Object Tag	Связанный с этой пиктограммой объект.

PFS. GUI. Controls. PFSGrid.FileTypes	Класс – описание типа файла для ячейки выбора имени файла.
Методы
Название	Описание
FileTypes(string type, string ext)	Конструктор. В качестве параметра передаются тип файла и его расширение. Например FileTypes("All files (*.*)", "*.*"). По умолчанию ячейка выбирает все файлы.

Аргументы событий редактирования

Щелчок (или двойной щелчок) по ячейке

PFS.GUI.Controls.PFSGrid.ClickEventArgs	Событие - щелчок мыши
Свойство
Название	Описание
Int32 ItemIndex	Индекс строки, по которой щелкнули
Int 32 ColumnIndex	Индекс столбца, по которому щелкнули

Изменение ширины колонки

PFS. GUI. Controls. PFSGrid. ColumnResizeEventArgs	Аргументы события "Изменение ширины колонки"
Свойство
Название	Описание
Int32 ColumnIndex	Номер столбца
Int32 ColumnWidth	Текущая ширина столбца

Редактирование ячейки

PFS. GUI. Controls. PFSGrid. CellEditEventArgs	Аргументы для события - редактирование значения ячейки
Свойства
Название	Описание
PFSubItem SubItem	Ссылка на редактируемую ячейку.
Int32 CellCol	Индекс выделенной колонки
Int32 CellRow	Индекс выделенной строки
DynamicProperty Property	Динамическое свойство, с которым связана ячейка
Bool Entered	1. Если true - редактируемые значения приняты 2. Если false - отмена принятия значений. 3. Tercium Non Datur :))

Щелчок мышью по кнопке в ячейке

PFS. GUI. Controls. PFSGrid. CellButtonArgs	Аргументы события ButtonPushed
Свойства
Название	Описание
Int32 Row	Номер строки, в которой нажата кнопка
Int32 Col	Номер столбца, в котором нажата кнопка

Изменение величины в элементе редактирования без завершения режима редактирования

PFS. GUI. Controls. PFSGrid. ValueChangeArgs	Аргументы события ValueChange
Свойства
Название	Описание
PFSubItem SubItem	Ячейка, значение которой динамически редактируется
DynamicProperty NewValue	Вернуть значение в формате DynamicProperty

Изменение индекса или текста в выпадающем списке без завершения редактирования

PFS. GUI. Controls. boboxChangeArgs	Аргументы события ComboboxValueChange
Свойства
Название	Описание
Int32 SelectedIndex	Выбранный индекс выпадающего списка
Object SelectedItem	Выбранных объект выпадающего списка
String Text	Текст выпадающего списка

Перетягивание колонки или строки

PFS. GUI. Controls. PFSGrid. DragEventArgs	Аргументы события перетягивания колонки или столбца
Константы
Название	Описание
Int32 COLUMN_DRAGGED	Перетянута колонка
Int32 ROW_DRAGGED	Перетянута строка
Свойства
Название	Описание
Int32 Action	Описание действия, которое произошло.
Int32 From	Исходная позиция колонки или строки
Int32 To	Новая позиция колонки или строки

PFS. GUI. Controls. PFSGrid. SortEventArgs	Аргументы события сортировки
Свойства
Название	Описание
Int32 Column	Номер колонки, по которой будет производится сортировка
SortDirection Direction	Направление сортировки
Bool Cancel	Отменить или разрешить сортировку. Если установить в true, то сортировка не будет произведена

Компараторы

Компараторы устанавливаются заголовкам колонок и определяют алгоритм сравнения строк при сортировке. Компаратор должен быть построен на базе стандартного базового компаратора PFBaseComparer и реализовывать стандартный интерфейс. NET IComparer.

PFS. GUI. Controls. PFSGrid. PFBaseComparer	Базовый компаратор. На основе этого компаратора должны быть все компараторы
Свойства
Название	Описание
SortDirection Direction	Направление сортировки
Int32 Column	Номер колонки для сортировки

Библиотекой уже предопределены три компаратора:

PFItemComparer	Компаратор сравнения строк. Значения в ячейках сравниваются как строки.
PFItemNumericComparer	Компаратор сравнения строк. Значения в ячейках сравниваются как числа
PFItemDateComparer	Компаратор сравнения строк. Значения в ячейках сравниваются как даты

Перечисления

PFS. GUI. Controls. PFSGrid. ColumnStates	Текущее состояние колонок
Значение	Описание
csNone	Колонка в нормальном состоянии
csPressed	Колонка в состоянии - нажата
csHot	Курсор над колонкой, но кнопки не нажаты

PFS. GUI. Controls. PFSGrid. DynamicPropertyType	Типы поддерживаемых динамических свойств
Значение	Описание
Boolean	Объект DynamicProperty описывает булевую величину. В ячейке отображается пиктограмма флажка.
Integer	Объект DynamicProperty описывает целое со знаком. Во время редактирования в ячейке отображается числовое поле ввода. В данном случае, можно установить границы и инкремент для редактирования, с помощью свойств Minimum, Maximum и Increment.
DateTime	Объект DynamicProperty описывает в себе структуру DateTime. Во время редактирования ячейки отображается стандартный экранный элемент ввода даты (DateTimePicker).
Date	Объект DynamicProperty описывает в себе структуру DateTime, но в режиме редактирования экранный элемент позволяет изменять только дату.
Time	Объект DynamicProperty описывает в себе структуру типа DateTime, но во время редактирования экранный элемент позволяет редактировать только время.
Decimal	Объект DynamicProperty описывает вещественное число со знаком. Во время редактирования отображается числовое поле ввода. В данном случае можно установить границы, инкремент и разрядность с помощью свойств Minimum, Maximum, Increment и DecimalPlaces.
String	Объект DynamicProperty описывает строку. В режиме редактирования в ячейке появляется текстовое поле ввода (TextBox). Возможен вариант выбора значения строки из нескольких предопределенных. Для этого необходимо создать массив строк (string[]), который содержит в себе варианты, и передать его объекту DynamicProperty, через свойство Variants. При этом в режиме редактирования в ячейке появится выпадающий список (Combobox). Если у объекта установить свойство EnableEditVariants в true, то значение выпадающего списка можно редактировать. В противном случае выпадающий список не редактируется.
FileName	Объект DynamicProperty описывает имя файла. При этом само имя файла, возвращаемое через свойство PropertyValue имеет тип string. В режиме редактирования в ячейке появляется поле ввода с кнопкой выбора имени файла, которая открывает стандартный диалог выбора имени файла.
Font	Объект DynamicProperty описывает шрифт, причем свойство PropertyValue задает и возвращает объект типа System.Windows.Forms.Font. В режиме редактирования появляется поле ввода имени шрифта, с кнопкой, открывающей стандартный диалог выбора имени шрифта.
ImageIndex	Свойство описывает Рисунок
Color	Объект DynamicProperty описывает цвет (Color). В режиме редактирования появляется выпадающий список выбора цвета. Свойство PropertyValue задает и возвращает тип Color.
LineWidth	Объект DynamicProperty описывает толщину линии в пикселах. В режиме редактирования появляется выпадающий список выбора толщины линии. Свойство PropertyValue возвращает и задает целое (int32) - толщину линии в пикселах.
LineStyle	Объект DynamicProperty описывает стиль линии. В режиме редактирования появляется выпадающий список выбора стиля линии. Свойство PropertyValue задает и возвращает тип DashStyle.

PFS.GUI.Controls.PFSGrid.SortDirections	Направление сортировки колонок
Значение	Описание
SortNothing	Неопределенное состояние сортировки
SortAscending	Сортировка по возрастанию
SortDescending	Сортировка по убыванию

PFS. GUI. Controls. PFSGrid. ListStates	Состояние таблицы
Значение	Описание
stateNone	Обычное
stateSelecting	Выбрана строка
stateColumnSelect	Выбрана колонка
stateColumnResizing	Колонка в данный момент выбирается (или изменяется ее ширина)

PFS. GUI. Controls. PFSGrid. PFListRegion	Область таблицы
Значение	Описание
header	Область заголовка
client	Область, занятая строками (таблица)
nonclient	Область вне строк таблицы

PFS.GUI.Controls.PFSGrid.PFGridLines	Направление линий сетки
Значение	Описание
gridNone	Нет линий
gridBoth	Горизонтальные и вертикальные линии
gridVertical	Только вертикальные линии
gridHorizontal	Только горизонтальные линии

PFS. GUI. Controls. PFSGrid. PFGridTypes	Тип сетки, можно установить сетку на всю область, занимаемую таблицей, или только на область, занимаемую ячейками
Значение	Описание
gridNormal	Линии сетки рисуются в пределах всей таблицы
gridOnExists	Горизонтальные линии рисуются только в пределах ширины ячеек

PFS.GUI.Controls.PFSGrid.PFControlStyles	Стиль заголовков колонок
Значение	Описание
Normal	Обычный
SuperFlat	Плоские заголовки

[1] Описание всех классов приведены ниже