Описание компонента Delphi StringGrid

Компонент Delphi StringGrid используется для отображения информации в табличной форме. В панели компонентов Delphi расположен на закладке Additional.

В основном ячейки компонента StringGrid могут содержать строковые значения, но можно так же добавить изображения в ячейки StringGrid.

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

Рисунок: Компонент StringGrid

Свойства компонента Delphi StringGrid

* Здесь указаны только специфические свойства данного компонента. Свойства типичные для большинства компонентов, такие как свойства позиционирования можно найти в отдельной статье.

В следующей таблице описаны параметры свойства Options компонента.

Примеры операций с компонентом Delphi StringGrid

Назначения размера таблицы:

MyStringGrid.ColCount := 10;
MyStringGrid.RowCount := 20;

Программный ввод данных в ячейки таблицы:

MyStringGrid.Cells[1, 2] := 'Мой текст';

здесь значения: 1 – номер столбца, 2 – номер строки.

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

MyStringGrid.Cells[0, 0] := 'Мой текст';

Пронумеровать колонку:

var
   i : Integer;
begin
   for i := 0 to MyStringGrid.RowCount - 1 do
      MyStringGrid.Cells[0, i] := IntToStr(i);
end;

Выделение отдельной ячейки:

MyStringGrid.Col := 2; // столбец
MyStringGrid.Row := 2; // строка

Программное управление групповым свойством Options:

// Включение редактирования, другие параметры без изменений
MyStringGrid.Options:=MyStringGrid.Options+[goEditing];

// Выключение редактирования, другие параметры без изменений
MyStringGrid.Options:=MyStringGrid.Options-[goEditing];

// Указывается список включенных параметров, остальные выключены
MyStringGrid.Options:=[goFixedVertLine, goFixedHorzLine, goVertLine, goHorzLine];

Очистка всех ячеек может быть выполнена по столбцам, строкам или по отдельным ячейкам:

// по столбцам
var
    i : Integer;
begin
    for i := 0 to MyStringGrid.ColCount - 1 do
      MyStringGrid.Cols[i].Clear;
end;

// по строкам
var
    i : Integer;
begin
    for i := 0 to MyStringGrid.RowCount - 1 do
       MyStringGrid.Rows[i].Clear;
end;

// по отдельным ячейкам
var
    i, j: Integer;
begin
    for i := 0 to MyStringGrid.RowCount - 1 do
      for j := 0 to MyStringGrid.ColCount - 1 do
         MyStringGrid.Cells[j, i]:='';
end;