TCustomControl - TCustomGrid - TCustomDrawGrid - TDrawGrid

Страница Палитры Компонентов: Additional.

Таблица StringGrid является экземпляром класса TStringGrid и предназначена для ото­бражения двумерной информации, например элементов матрицы. В таблице может нахо­диться произвольное количество строк и столбцов. Если зафиксировать необходимое количество первых строк и столбцов, то можно задать заголовки строк и столбцов, по­стоянно присутствующие в окне компонента, в том числе при горизонтальном и верти­кальном скроллинге.

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

Нумерация строк и столбцов таблицы начинается с нуля. Координаты каждой ячейки таблицы задаются парой чисел, первое из которых является номером столбца, а второе - номером строки. Например, ячейка с координатами (3,5) расположена в четвертом стол­бце и шестой строке.

Класс TCustomGrid, являющийся предком класса TStringGrid, содержит определение многих характеристик, общих для любых таблиц. Многие из них определяет внешний вид таблицы. Рассмотрим основные свойства класса TCustomGrid.

property Col: Longint;

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

property ColCount: Longint;

Задает число столбцов в таблице.

property ColWidths[Index: Longint]: Integer;

Задает ширину каждого столбца в таблице. Доступно только на этапе выполнения про­граммы.

property DefaultColWidth: Integer;

Задает исходную ширину всех столбцов. Для задания ширины отдельного столбца следует использовать свойство ColWidths.

property DefauItDrawing: Boolean;

Если свойство имеет значение True, то прорисовка ячеек при рисовании таблицы бу­дет происходить автоматически, в противном случае необходимо создать свои сред­ства отображения.

property DefaultRowHeight: Integer;

Задает исходную высоту всех строк. Для задания высоты отдельной строки следует использовать свойство RowHeights.

property FixedColor: TColor;

Задает цвет фиксированных ячеек.

property FixedCols: Integer;

Задает число фиксированных столбцов. По умолчанию задается один фиксированный столбец.

property FixedRows: Integer;

Задает число фиксированных строк. По умолчанию задается одна фиксированная стро­ка.

property GridLineWidth: Integer;

Задает толщину линий между ячейками в пикселях.

property Row: Longint;

Задает строку, в которой находится активная ячейка. Доступно только на этапе выпол­нения программы.

property RowCount: Longint;

Задает число строк таблицы.

property RowHeights| Index: Longint]: Integer;

Задает высоту каждой строки таблицы. Доступно только на этапе выполнения программы.

type TGridCoord = record

X: Longint;

Y: Longint;

End;

type TGridRect = record case Integer of

0: (Left, Top, Right, Bottom: Longint);

1: (TopLeft, BottomRight: TGridCoord);

End;

property Selection: TGridRect;

Указывает область текущего выделения. При выделении указываются номера строк и столбцов. Доступно только на этапе выполнения программы.

Для определения поведения таблицы используется свойство Options. Прежде чем привести описание этого свойства, заметим, что каждая ячейка таблицы может находится в одном из пяти состояний: пассивном, выделенном (выделена особым цветом), ак­тивном (выделена рамкой из точек), фиксированном (тоже выделена особым цветом) и в состоянии редактирования (значение флага goEditing свойства Options равно True).

type

TGridOption = (goFixedVertLine, goFixedHorzLine, goVertLine, goHorzLine, goRangeSelect, goDrawFocusSelected, goRowSizing, goColSizing, goRowMoving, goColMoving, goEditing, goTabs, goRowSelect, goAlwaysShowEditor, goThumbTracking);

TGridOptions = set of TGridOption;

property Options: TGridOptions;

Задает флаги, определяющие поведение таблицы. Флаги означают следующее:

goFixedVertLine — фиксированные ячейки разделяются вертикальными лини­ями;

goFixedHorzLine - фиксированные ячейки разделяются горизонтальными линиями;

goVertLine - остальные ячейки разделяются вертикальными линиями;

goHorzLine - остальные ячейки разделяются горизонтальными линия­ми;

goRangeSelect — допустимо выделение нескольких ячеек;

goDrawFocusSelected - активная ячейка закрашивается тем же цветом, которым закрашивается и выделенная, в противном случае закра­шивается цветом нейтральных ячеек;

goRowSizing; - высота строк таблицы может изменяться;

goColSizing — ширина столбцов таблицы может изменяться;

goRowMoving - строки таблицы могут перемещаться;

goColMoving - столбцы таблицы могут перемещаться;

goEditing - ячейки могут редактироваться;

goTabs — переход от ячейки к ячейке возможен с помощью клави­ши Tab (клавиш Shift+Tab);

goRowSelect' " выделение только целых строк таблицы;

goAlwaysShowEditor — при выделении ячейки она сразу же становится и актив­ной (в противном случае активизируется либо клавишей F2, либо двойным нажатием клавиши мыши, либо нажа­тием какой-либо символьной клавиши);

goThumbTracking — перемещение подвижной части таблицы синхронно с перемещением ползунка линейки скролинга (в противном случае перемещение осуществляется только после того, как ползунок будет отпущен).

Рассмотрим теперь основные свойства класса TStringGrid, позволяющие осуществ­лять доступ к данным, находящимся в ячейках таблицы. Все перечисленные ниже свой­ства доступны только на этапе выполнения программы.

property Cells [ACol, ARow: Integer]: string;

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

property Cols[lndex: Integer]: TStrings;

Содержит список строк, принадлежащих ячейкам столбца с индексом Index.

property Objects[ACol, ARow: Integer]: TObject;

Содержит двумерный массив, элементами которого являются указатели на объекты, каждый из которых ассоциирован с соответствующей ему ячейкой, находящейся в столбце ACol и строке ARow.

property Rows[Index: Integer]: TStrings;

Содержит список строк, принадлежащих ячейкам строки с индексом Index.

Событием по умолчанию для таблицы StringGrid является событие onClick.