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

Заголовок колонки.

Заголовок представляет собой коллекцию заголовков колонок. Заголовок колонок представлен классом PFColumn и имеет свойства и методы, перечисленные ниже.

PFS. GUI. Controls. PFSGrid. PFColumn	Заголовок колонки
Свойства
Название	Описание
Dictionary Dictionary	Словарь для данной колонки. Автоматически пополняется при добавлении строк в таблицу. Данный объект полезен для накопления информации по значениям в колонках при организации фильтров. Внимание! При изменении значения ячеек у строк, уже добавленных в таблицу, обновления информации не происходит!
BaseComparer Comparer	Компаратор сортировки для данного столбца. Если равен null, то сортировка по щелчку мыши для этой колонки работать не будет. При этом если запустить сортировку вызовом метода SortColumn таблицы, величины в ячейках сравниваются как строки
Bool Visible	Видимость столбца
Int32 ImageIndex	Индекс пиктограммы, отображаемой в колонке
System. Windows. Form. ContentAlighment TextAlignment	Выравнивание текста в колонке
SortDirection LastSortState	Направление последней сортировки. Задание значения через это свойство вызовет установку этого свойства в состояние SortNothing для остальных колонок.
Int32 Width	Ширина колонки
String Text	Текст заголовка в колонке
String Name	Внутреннее имя колонки. По этому имени работает индексатор коллекции.
ColumnStates State	Состояние колонки
Методы
Название	Описание
Void SetLastSortDirection (SortDirections direct)	Установить свойство LastSortState без корректировки остальных колонок. Это означает, что установка свойства через этот метод не вызовет изменения свойств LastSortState у остальных колонок.

Заголовок таблицы.

Заголовок таблицы представляет собой коллекцию заголовков колонок.

PFS. GUI. Controls. PFSGrid. PFColumnCollection	Заголовок таблицы
Методы
Название	Описание
Void AddToDictionary(PFItem item)	Добавить в словарь значения из строки
Void RemoveFromDictionary(PFItem item)	Удалить из словаря значения строки
Void ClearDictionaries()	Очистить все словари
Void RollRight(Int32 count)	Циклический сдвиг заголовков вправо на count позиций
Void RollRight()	Циклический сдвиг заголовков вправо на одну позицию
Void RollLeft(Int32 count)	Циклический сдвиг заголовков влево на count позиций
Void RollLeft()	Циклический сдвиг заголовков влево на одну позицию
Void MoveRight(Int32 index)	Сместить заголовок с индексом index на одну позицию вправо
Void MoveLeft(Int32 index)	Сместить заголовок с индексом index на одну позицию влево
Void ShiftMove(Int32 from, Int32 to)	Переместить заголовок с позиции from на позицию to cо сдвигом ячеек внутри диапазона [from..to]
Void SimpleMove(Int32 form, Int32 to)	Поменять местами ячейки в позициях from и to
Void Int GetColumnIndex(String name)	Получить текущий индекс колонки
Void Int GetStartIndex(PFColumn column)	Получить начальный индекс колонки. Начальный индекс присваивается заголовку (или колонке) в момент ее добавления в таблицу. При этом в течении жизни таблицы он не меняется. Текущий индекс может быть изменен (либо программным путем, либо через перетаскивание колонки пользователем)
PFColumn GetColumnByStartIndex(Int32 start_index)	Получить ссылку на колонку по ее стартовому индексу
Int32 GetColX(Int32 number)	Получить сумму ширин всех видимых колонок до колонки с номером number.
Void Add(PFColumn column)	Добавить заголовок в коллекцию колонок
Void Add(String name, Int32 width)	Добавить заголовок в коллекцию колонок и именем и шириной колонки.
Void Add(String name, Int32, width, System. Windows. Forms. HorizontalAlignment alignment)	Добавить заголовок в коллекцию колонок с именем, шириной колонки и выравниванием текста.
Void AddRange(PFColumn[] columns)	Добавить пакет заголовков в коллекцию колонок.
Void Remove(PFColumn column)	Удалить колонку из коллекции
Void RemoveAt(Int32 index)	Удалить колонку из коллекции. В качестве индекса удаления выступает начальный индекс, а не текущее положение колонки в коллекции.
Void Clear()	Удалить все колонки из коллекции
Void IndexOf(PFColumn column)	Вернуть текущий индекс колонки.
Void ClearStates()	Сбросить все состояния колонок (Установка свойств State в csNone)
Void ClearHotStates()	Установить в csNone свойства только тех колонок, которые имеют свойство State равное csHot
Bool AnyPressed()	Вернет true, если хотя бы одно свойство State установлено в csHot
Свойства
Свойство	Описание
PFColumn Item(Int32 index)	Индексатор
PFColumn Item(String name)	Индексатор по имени колонки
Int32 Width	Общая ширина всех колонок

Класс – ячейка таблицы (PFSubItem)

PFS. GUI. Controls. PFSGrid. PFSubItem	Класс - ячейка строки таблицы
Методы
Название	Описание
Void SetImageIndex(Int32 image_index)	Установка свойства ImageIndex без перерисовки таблицы
Void SetImage(Bitmap bitmap)	Установка картинки (свойства Image) без перерисовки ячейки
Void SetImageAlignment ( System. Windows. Forms. HorizontalAlignment alignment)	Установка свойства ImageAligment без перерисовки таблицы
Void SetTextAligment( System. Drawing. ContentAlignment alignment )	Установка свойства TextAligment без перерисовки таблицы
Void SetProperty (Object prop_value, DynamicPropertyType prop_type)	Установить значение динамического свойства ячейки вместе с его типом. Типы передаваемого объекта и описание типа в терминах DynamicPropertyType должны совпадать. При этом значение текста в ячейке также будет изменено.
Void SetProperty(Object prop_value)	Установить только значение динамического свойства в ячейке. Тип передаваемого объекта и тип, описанный ячейкой должны совпадать. Вызов метода также изменит значение текста.
Void SetText(String text)	Установка текста без перерисовки таблицы
Void SetForeColor(Color color)	Установка свойства ForeColor без перерисовки таблицы
Void SetBackColor(Color color)	Установка свойства BackColor без перерисовки таблицы
Void SetSelected(Bool selected)	Установка свойства Selected без перерисовки основной таблицы
Void SetDecimalPlaces(Int32 decimal_places, Bool refresh)	Установить количество знаков после точки при отображении. Имеет смысл только для вещественных чисел.
Void SetNonColoredValue(Decimal val, String text)	Задать значение типа decimal и текст без перерисовки таблицы
Void SetNonColoredValue(Decimal val, String text, Bool refresh)	Изменить значение типа decimal и текст с обновлением информации в ячейке
Void SetNonColoredValue(Decimal val)	Задать значение типа decimal без перерисовки таблицы.
Void SetValue(Decimal val, String text, Bool refresh)	Метод введен дополнительно для ProTrader. Метод задает ячейке вещественное значение, но в качестве текста отображается значение параметра appearance.
Свойства
Название	Описание
System. Windows. Forms. HorizontalAlignment ImageAlignment	Выравнивание пиктограммы внутри ячейки
SetTextAligment(System. Drawing. ContentAlignment TextAlignment	Выравнивание текста внутри ячейки
Object Tag	Дополнительная информация или связанный с этой ячейкой объект
Bool BeingEdited	Признак того, что данная ячейка в данный момент редактируется
String LocalKey	Ключ локализации
DynamicProperty Property	Описание свойства для редактирования. Режим редактирования для этой ячейки не работает, если это свойство обнулено, или EnableEditing установлено в false
Bool EnabledEditing	Разрешить или запретить редактирование ячейки.
Bool EnableOneClickEditing	Разрешить или запретить редактирование по одному щелчку. По умолчанию для редактирования ячейки необходимо дважды щелкнуть по ней. При этом, если в этот момент редактировалась какая-нибудь другая ячейка, ее редактирование завершается.
Bool EnableOnUpdateValue	Разрешить или изменение значения ячейки при изменении значения элемента редактировании При этом редактирование значения ячейки продолжается.
Bool EnableAutoApply	Если установить данный флаг, то изменения в ячейке будут приняты автоматически при завершении редактирования в случае передачи фокуса другой ячейке. Внимание! Если для этой ячейки был установлен флаг EnableOnUpdateValue, то значение ячейки будет изменено, если изменялось значение в элемент редактирования. Таким образом, в этом случае, значение флага EnableAutoApply не имеет смысла.
Object Obj	Дополнительный объект, связанный с данной ячейкой.
Int32 ValueCode	Номер ячейки в колонке. Устанавливается программой-пользователем. Дополнительно введен в целях оптимизации распознавания ячейки в событиях изменения.
Bool IsButtoned	Поле в режиме редактирования будет представлять собой кнопку. При этом, поведение кнопки аналогично поведению любого другого элемента редактирования. Кнопка вызывает событие OnButtonPushed. Значение ячейки в этом случае не меняется.
String Text	Текст в ячейке
Color ForeColor	Цвет текста в ячейке
Color BackColor	Цвет фона в ячейке
Bool Selected	Признак принадлежности ячейки к выделенной строке.
Bool EnableArrowing	Разрешить или запретить появление стрелок (пиктограмм)
Bool BorderedArrows	Пиктограммы с ободком или без
Bool EnableColoring	Разрешить изменение цвета ячейки при задании значений.
Color UpBackColor	Цвет фона ячейки при увеличении значения ячейки. Данное свойство имеет смысл только для чисел.
Color DownBackColor	Цвет фона ячейки при уменьшении значения ячейки. Данное свойство имеет смысл только для чисел.
Color NoChangeBackColor	Цвет фона ячейки, если задаваемое значение равно значению ячейки. Данное свойство имеет смысл только для чисел.
Color UpForeColor	Цвет текста ячейки при увеличении значения ячейки. Данное свойство имеет смысл только для чисел.
Color DownForeColor	Цвет текста ячейки при уменьшении значения ячейки. Данное свойство имеет смысл только для чисел.
Color NoChangeForeColor	Цвет текста ячейки, если задаваемое значение равно значению ячейки. Данное свойство имеет смысл только для чисел.
Decimal Value	Числовое значение, задаваемое ячейке. Присвоение числового значения ячейке через это свойств влияет на раскраску ячейки и рисование пиктограмм. При этом, динамическое свойство должно описывать либо целый, либо вещественный тип. В противном случае попытка задать значение приведет к исключению.

Класс – коллекция ячеек.