Difference between revisions of "TsWorksheetGrid/ru"

From Free Pascal wiki
Jump to navigationJump to search
m (Fixed syntax highlighting)
 
(8 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
{{TsWorksheetGrid}}
 
{{TsWorksheetGrid}}
 
 
----
 
<span style="color:#FF0000">ENG: '''AT THE MOMENT THIS PAGE IS UNDER TRANSLATION.''' <br /> RUS: '''В НАСТОЯЩИЙ МОМЕНТ СТРАНИЦА НАХОДИТСЯ В ПРОЦЕССЕ ПЕРЕВОДА.'''</span>
 
----
 
 
 
 
----
 
----
 
-- [[User:Zoltanleo|Zoltanleo]] 15:36, 21 September 2018 (CEST) Ввиду сложности дословного перевода текста с английского на русский слова, требующиеся по смыслу, но отсутствующие в английской версии, указаны в квадратных скобках.
 
-- [[User:Zoltanleo|Zoltanleo]] 15:36, 21 September 2018 (CEST) Ввиду сложности дословного перевода текста с английского на русский слова, требующиеся по смыслу, но отсутствующие в английской версии, указаны в квадратных скобках.
Line 27: Line 20:
 
==== Запись значений ячеек ====
 
==== Запись значений ячеек ====
 
Используйте этот код для записи данных в ячейку в <tt>TsWorksheetGrid</tt> с именем <tt>Grid</tt> для простоты:
 
Используйте этот код для записи данных в ячейку в <tt>TsWorksheetGrid</tt> с именем <tt>Grid</tt> для простоты:
<syntaxhighlight>
+
<syntaxhighlight lang=pascal>
 
   // Записываем строку
 
   // Записываем строку
 
   Grid.Cells[1, 1] := 'Это - строка';   
 
   Grid.Cells[1, 1] := 'Это - строка';   
Line 45: Line 38:
 
==== Чтение значений ячеек ====
 
==== Чтение значений ячеек ====
 
Точно так же значения ячеек можно считывать в переменные выделенных типов:
 
Точно так же значения ячеек можно считывать в переменные выделенных типов:
<syntaxhighlight>
+
<syntaxhighlight lang=pascal>
 
var
 
var
 
   str: String;
 
   str: String;
Line 59: Line 52:
 
Так как свойство Cells является [типом] вариант, сравнение строки со строкой немного сложнее. Используйте функцию преобразования строк в вариант <tt>VarToStr()</tt>, предоставляемую модулем <tt>variant</tt>.
 
Так как свойство Cells является [типом] вариант, сравнение строки со строкой немного сложнее. Используйте функцию преобразования строк в вариант <tt>VarToStr()</tt>, предоставляемую модулем <tt>variant</tt>.
  
<syntaxhighlight>
+
<syntaxhighlight lang=pascal>
 
   // Это простое сравнение не удастся:
 
   // Это простое сравнение не удастся:
 
   // if Grid.Cells[1,1] = 'Это - строка' then ...
 
   // if Grid.Cells[1,1] = 'Это - строка' then ...
Line 68: Line 61:
  
 
Численные значения часто можно сравнивать без явного преобразования:
 
Численные значения часто можно сравнивать без явного преобразования:
<syntaxhighlight>
+
<syntaxhighlight lang=pascal>
 
   if Grid.Cells[1,2] = 1.2345 then ...
 
   if Grid.Cells[1,2] = 1.2345 then ...
 
</syntaxhighlight>
 
</syntaxhighlight>
Line 84: Line 77:
 
  формулой, имели значения при ее вводе.
 
  формулой, имели значения при ее вводе.
  
<syntaxhighlight>
+
<syntaxhighlight lang=pascal>
 
// Включаем автоматический расчет формул
 
// Включаем автоматический расчет формул
 
Grid.AutoCalc := true;         
 
Grid.AutoCalc := true;         
Line 143: Line 136:
  
 
Этот пример добавляет формулу для сегодняшней даты в ячейку A1, форматирует ячейки для отображения числа в качестве даты и выбирает белый шрифт курсивом на светло-сером фоне. Вокруг ячейки пунктиром рисуется красная рамка.
 
Этот пример добавляет формулу для сегодняшней даты в ячейку A1, форматирует ячейки для отображения числа в качестве даты и выбирает белый шрифт курсивом на светло-сером фоне. Вокруг ячейки пунктиром рисуется красная рамка.
<syntaxhighlight>
+
<syntaxhighlight lang=pascal>
 
const
 
const
 
   RED_DOTTED_BORDER: TsBorderStyle = (LineStyle: lsDotted; Color: scRed);
 
   RED_DOTTED_BORDER: TsBorderStyle = (LineStyle: lsDotted; Color: scRed);
Line 172: Line 165:
 
[Процесс] определения границ ячеек для более крупного блока ячеек с помощью этих свойств [вручную] будет довольно громоздким, потому что могут использоваться различные стили для внутренних, внутренних и внутренних ячеек. Чтобы решить эту задачу проще, сетка предоставляет метод <tt>ShowCellBorders</tt>, который получает координаты блока ячейки и стили левой, верхней, правой, нижней внешней и горизонтальной и вертикальной внутренних линий границы. Используйте константу <tt>NO_CELL_BORDER</tt>, при которой граница не должна быть выделена в определенном месте:
 
[Процесс] определения границ ячеек для более крупного блока ячеек с помощью этих свойств [вручную] будет довольно громоздким, потому что могут использоваться различные стили для внутренних, внутренних и внутренних ячеек. Чтобы решить эту задачу проще, сетка предоставляет метод <tt>ShowCellBorders</tt>, который получает координаты блока ячейки и стили левой, верхней, правой, нижней внешней и горизонтальной и вертикальной внутренних линий границы. Используйте константу <tt>NO_CELL_BORDER</tt>, при которой граница не должна быть выделена в определенном месте:
  
<syntaxhighlight>
+
<syntaxhighlight lang=pascal>
 
const
 
const
 
   THICK_CELL_BORDER: TsCellBorderStyle = (LineStyle: lsThick; Color: clBlack);
 
   THICK_CELL_BORDER: TsCellBorderStyle = (LineStyle: lsThick; Color: clBlack);
Line 197: Line 190:
  
 
'''Пример:'''
 
'''Пример:'''
<syntaxhighlight>
+
<syntaxhighlight lang=pascal>
 
Grid.Cells[1,1] := '=pi()';
 
Grid.Cells[1,1] := '=pi()';
 
Grid.CellComment[1,1] := 'Число pi необходимо для вычисления площади и окружности круга.';
 
Grid.CellComment[1,1] := 'Число pi необходимо для вычисления площади и окружности круга.';
Line 207: Line 200:
  
 
'''Пример:'''
 
'''Пример:'''
<syntaxhighlight>
+
<syntaxhighlight lang=pascal>
 
// Пример добавления внешней гиперссылки
 
// Пример добавления внешней гиперссылки
 
Grid.Cells[1,1] := 'Lazarus';
 
Grid.Cells[1,1] := 'Lazarus';
Line 235: Line 228:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
{{Note|Follow the instructions [[#Cell_comments|above]] to show the tooltip text as a popup window. Следуйте инструкциям [[#Комментарии ячейки|выше]], чтобы отобразить текст всплывающей подсказки в виде всплывающего окна.}}
+
{{Note|Следуйте инструкциям [[#Комментарии ячейки|выше]], чтобы отобразить текст всплывающей подсказки в виде всплывающего окна. }}
  
=== Merged cells ===
+
=== Объединенные ячейки ===
  
A rectangular group of cells can be merged to a single block. The content of the top/left cell of this block is displayed across all the combined cells, the content of the other cells is ignored.
+
Прямоугольная группа ячеек может быть объединена в один блок. Содержимое верхней/левой ячейки этого блока отображается во всех объединенных ячейках, содержимое других ячеек игнорируется.
  
Use the method <tt>MergeCells</tt> to perform this operation. As parameters, it requires the left, top, right and bottom coordinates of the cell range to be merged. They also can be combined into a a <tt>TRect</tt> record. The method <tt>Unmerge</tt> splits a previously merged block again in the individual cells, here the coordinates of a single cell from the merged range is sufficient.
+
Используйте метод <tt>MergeCells</tt> для выполнения этой операции. В качестве параметров требуется объединить левую, верхнюю, правую и нижнюю координаты диапазона ячеек. Они также могут быть объединены в запись <tt>TRect</tt>. Метод <tt>Unmerge</tt> снова разделяет ранее объединенный блок на отдельные ячейки, здесь достаточно координат одной ячейки из объединенного диапазона.
  
<syntaxhighlight>
+
<syntaxhighlight lang=pascal>
   // Example for merging
+
   // Пример слияния
   Grid.MergeCells(1,1, 3,1);          // Combine the first 3 cells of the first row
+
   Grid.MergeCells(1,1, 3,1);          // Объединяем первые 3 ячейки первой строки
   Grid.Cells[1,1] := 'Summary';       // Write the text "Summary" across the 3 cells
+
   Grid.Cells[1,1] := 'Итого';         // Записываем текст "Итого" по 3 ячейкам
   Grid.HorAlignment[1,1] := haCenter; // and center it.
+
   Grid.HorAlignment[1,1] := haCenter; // и центрируем его
  
   // Example for unmerging
+
   // Пример разделения
   Grid.UnmergeCells(1,1);            // Splits the merged block (1,1..3,1)
+
   Grid.UnmergeCells(1,1);            // Разделяем объединенный блок (1,1..3,1)
 
</syntaxhighlight>
 
</syntaxhighlight>
  
=== Column widths and row heights ===
+
=== Ширина столбцов и высота строк ===
  
 
Column widths and row heights can be changed for all cells by setting the <tt>DefaultColWidth</tt> and <tt>DefaultRowHeight</tt>. This works also in design mode. In addition, the widths and heights of particular columns and rows can be modified by the properties <tt>ColWidths[ACol]</tt> and <tt>RowHeights[ARow]</tt>. These values must be given in pixels.
 
Column widths and row heights can be changed for all cells by setting the <tt>DefaultColWidth</tt> and <tt>DefaultRowHeight</tt>. This works also in design mode. In addition, the widths and heights of particular columns and rows can be modified by the properties <tt>ColWidths[ACol]</tt> and <tt>RowHeights[ARow]</tt>. These values must be given in pixels.
  
<syntaxhighlight>
+
Ширину столбцов и высоту строк можно изменить для всех ячеек, определив [свойства] <tt>DefaultColWidth</tt> и <tt>DefaultRowHeight</tt>. Это работает также в режиме разработки. Кроме того, ширина и высота отдельных столбцов и строк могут быть изменены свойствами <tt>ColWidths[ACol]</tt> и <tt>RowHeights[ARow]</tt>. Эти значения должны указываться в пикселях.
   Grid.DefaultColWidth := 80;  // This is the width of all columns
+
 
   Grid.ColWidths[10] := 10;    // except for column #10 which is only 10 pixels wide.
+
<syntaxhighlight lang=pascal>
 +
   Grid.DefaultColWidth := 80;  // Это ширина всех столбцов,
 +
   Grid.ColWidths[10] := 10;    // исключая столбец #10, ширина которого составляет всего 10 пикселей.
  
   Grid.DefaultRowHeight := 20; // All rows are 20 pixels high
+
   Grid.DefaultRowHeight := 20; // Все строки имеют высоту 20 пикселей,
   Grid.RowHeights[2] := 4;    // Row #2 serves as a spacer and is only 4 pixels high.
+
   Grid.RowHeights[2] := 4;    // Строка #2 служит в качестве разделителя и имеет высоту всего 4 пиксела.
 
</syntaxhighlight>
 
</syntaxhighlight>
  
=== New grid properties ===
+
=== Новые свойства сетки ===
In addition to the properties inherited from its ancestors <tt>TCustomDrawGrid</tt> and <tt>TCustomGrid</tt>, the <tt>TsWorksheetGrid</tt> introduces the following new '''published properties''':
+
В дополнение к свойствам, унаследованным от его предков <tt>TCustomDrawGrid</tt> и <tt>TCustomGrid</tt>, <tt>TsWorksheetGrid</tt> вводит следующие новые '''published-свойства''':
  
* '''AllowDragAndDrop''' (boolean): Cells can be dragged to a new location if this option is active. Move the mouse cursor to the border of the cells to be dragged until the mouse cursor becomes a four-sided arrow, and then begin dragging. If the dragged cell is referenced by a formula the formula is NOT updated - this behavior is different from Excel but agrees with Open/LibreOffice Calc.
+
* '''AllowDragAndDrop''' (boolean): если эта опция активна, ячейки можно перетащить в новое место. Переместите курсор мыши на границу ячеек, которые нужно перетащить, пока курсор мыши не станет четырехсторонней стрелкой, а затем начинайте перетаскивание. Если перетаскиваемая ячейка ссылается на формулу, формула НЕ обновляется - это поведение отличается от Excel, но согласуется с Open/LibreOffice Calc.
* '''AutoCalc''' (boolean): Formulas in the grid are automatically recalculated whenever cell content changes.
+
* '''AutoCalc''' (boolean): формулы в сетке автоматически пересчитываются при изменении содержимого ячейки.
 
* '''AutoExpand''' (set of <tt>aeData, aeNavigation, aeDefault</tt>):  
 
* '''AutoExpand''' (set of <tt>aeData, aeNavigation, aeDefault</tt>):  
** If the option <tt>aeData</tt> is contained in the set <tt>AutoExpand</tt> then the grid automatically expands if cells are written outside the predefined range.
+
** Если опция <tt>aeData</tt> содержится в наборе <tt>AutoExpand</tt>, тогда сетка автоматически расширяется, если ячейки записываются за пределами предопределенного диапазона.
** If <tt>AutoExpand</tt> contains the option <tt>aeNavigation</tt> then the user can ''navigate'' outside the predefined cell range; new rows and columns are automatically added to the grid (but not to the underlying worksheet). If a file is loaded into the grid then grid dimensions are automatically expanded to the range needed for the worksheet.  
+
** Если <tt>AutoExpand</tt> содержит параметр <tt>aeNavigation</tt>, тогда пользователь может ''перемещаться'' за пределами предопределенного диапазона ячеек; новые строки и столбцы автоматически добавляются в сетку (но не к основному листу). Если файл загружен в сетку, то размеры сетки автоматически расширяются до диапазона, необходимого для рабочего листа.
** The option <tt>aeDefault</tt> comes into play if a grid is smaller than the DEFAULT_COL_COUNT and DEFAULT_ROW_COUNT default values. If this option is included the grid is automatically expanded to this default size. On the other hand, if ony a given number of rows and columns should be contained in the grid the option <tt>aeDefault</tt> must be '''removed before''' setting <tt>RowCount</tt>/<tt>ColCount</tt>.
+
** Опция <tt>aeDefault</tt> вступает в игру, если сетка меньше значений по умолчанию DEFAULT_COL_COUNT и DEFAULT_ROW_COUNT. Если этот параметр включен, сетка автоматически расширяется до этого размера по умолчанию [(с добавлением "недостающих" столбцов и строк)]. С другой стороны, если в сетке должно содержаться только определенное количество строк и столбцов, опция <tt>aeDefault</tt> должна быть '''удалена до''' установки [свойств] <tt>RowCount</tt>/<tt>ColCount</tt>.
* '''EditorLineMode''' determines whether the grid's cell editor supports only single lines (<tt>elmSingleLine</tt>) or multiple lines (<code>elmMultiLine</code>). In the latter case, you can press CTRL+ENTER in order to begin a new line during editing a cell.
+
* '''EditorLineMode''' определяет, поддерживает ли редактор ячейки сетки только одиночные строки (<tt>elmSingleLine</tt>) или несколько строк (<code>elmMultiLine</code>). В последнем случае вы можете нажать CTRL + ENTER, чтобы начать новую строку во время редактирования ячейки.
* '''FrozenBorderPen''': if the grid has frozen panes (see <tt>FrozenCols</tt> and <tt>FrozenRows</tt>) a separating line is drawn out the edge of the last frozen row and column. The property <tt>FrozenBorderPen</tt> determines how this line is drawn. Set <tt>FrozenBorderPen.Style = psClear</tt> to hide these lines.
+
* '''FrozenBorderPen''': если сетка имеет замороженные панели (см. <tt>FrozenCols</tt> и <tt>FrozenRows</tt>), разделительная линия вытягивает край последней замороженной строки и столбца , Свойство <tt>FrozenBorderPen</tt> определяет способ рисования этой строки. Установите [значение свойства] <tt>FrozenBorderPen.Style = psClear</tt>, чтобы скрыть эти линии.
* '''FrozenCols''' and '''FrozenRows''' (integer): determines the number of non-scrolling columns (rows) at the left (top) of the grid. Technically these are custom-drawn fixed columns (rows) of the ancestor. Note that the user cannot navigate or edit cells within this range.
+
* '''FrozenCols''' и '''FrozenRows''' (integer): определяет количество НЕ прокручиваемых столбцов(строк) слева(сверху) сетки. Технически это настраиваемые фиксированные столбцы (строки) предка. Обратите внимание, что пользователь не может перемещаться или редактировать ячейки в этом диапазоне.
* '''ReadFormulas''' (boolean): Reads formulas from the input files. Since fpspreadsheet does not support all formulas available in the Office spreadsheet applications there is a chance that reading of a file may crash due to formulas; in this case, reading of formulas can be disabled.
+
* '''ReadFormulas''' (boolean): считывает формулы из входных файлов. Так как fpspreadsheet не поддерживает все формулы, доступные в приложениях электронной таблицы Office, есть вероятность, что при чтении файла может произойти сбой из-за формул; в этом случае чтение формул может быть отключено.
* '''SelectionPen''' (TPen): determines how the border of the selected cell is painted. By default, the selected cell is outlined by a 3-pixel-wide black line.
+
* '''SelectionPen''' (TPen): определяет, как окрашивается граница выбранной ячейки. По умолчанию выбранная ячейка выделена черной линией шириной 3 пикселя.
* '''ShowGridLines''' (boolean): allows to turn off the grid lines
+
* '''ShowGridLines''' (boolean): позволяет отключить линии сетки
* '''ShowHeaders''' (boolean): can be used to turn off the column and row headers ('A', 'B', 'C', ..., '1', '2', '3'). The property '''DisplayFixedColRow''' has the same effect, but is deprecated now.
+
* '''ShowHeaders''' (boolean): может использоваться для отключения заголовков столбцов и строк ('A', 'B', 'C', ..., '1', '2', '3'). Свойство '''DisplayFixedColRow''' имеет тот же эффект, но теперь устарело.
* '''TextOverflow''' (boolean): If this property is on then long text content is allowed to extend into adjacent cells if these are empty. Note that numerical data cells are rounded such that the cell does not overflow.
+
* '''TextOverflow''' (boolean): если это свойство включено, то длинному текстовому контенту разрешается распространяться на соседние ячейки, если они пусты. Обратите внимание, что ячейки числовых данных округлены так, что ячейка не переполняется.
* '''WorkbookSource''' (TsWorkbookSource): links to the workbook source which provides the data. If empty, the grid uses an internal workbook source.
+
* '''WorkbookSource''' (TsWorkbookSource): ссылки на источник рабочей книги, которые предоставляют данные. Если [ссылки] пустые, сетка использует внутренний источник рабочей книги.
  
'''Events'''
+
'''События'''
* '''OnClickHyperlink''': This event fires whenever the user clicks a cell with an embedded hyperlink. Since clicking a cell normally would bring a cell into edit mode it is necessary to hold the mouse key down for about half a second to trigger the hyperlink event.
+
* '''OnClickHyperlink''': это событие срабатывает всякий раз, когда пользователь нажимает на ячейку со встроенной гиперссылкой. Поскольку щелчок по ячейке обычно приведет к переключению ячейки в режим редактирования, необходимо удерживать клавишу мыши примерно на полсекунды, чтобы вызвать событие гиперссылки.
  
=== Recommended property values ===
+
=== Рекомендуемые значения свойств ===
In order to set up the grid to behave similar to the well-known Office applications we recommend the following grid property settings. It should be emphasized, though, that differences in usage do exist and cannot be removed without a major re-write of the inherited grid infrastructure:
+
Чтобы настроить сетку для работы аналогично хорошо известным приложениям Office, мы рекомендуем следующие настройки свойств сетки. Следует, однако, подчеркнуть, что различия в использовании существуют и не могут быть удалены без серьезной перезаписи унаследованной инфраструктуры сетки:
  
* <tt>AutoAdvance = aaDown</tt>: The ENTER key advances the selected cell to the next lower cell.
+
* <tt>AutoAdvance = aaDown</tt>: клавиша ENTER переводит [фокус] с выбранной ячейки в следующую нижнюю ячейку
* <tt>AutoCalc = true</tt>: Automatically calculate formulas
+
* <tt>AutoCalc = true</tt>: автоматическое вычисление формул
* <tt>AutoEdit = true</tt>: For editing a cell, just begin typing. Alternatively you can begin edit mode by pressing F2.
+
* <tt>AutoEdit = true</tt>: для редактирования ячейки просто начинайте печатать. Кроме того, вы можете начать редактирование, нажав F2
* <tt>AutoExpand = [aeData, aeNavigation, aeDefault]</tt>: Don't restrict usage of the grid to the predefined grid dimensions, for an Excel-like user-interface.
+
* <tt>AutoExpand = [aeData, aeNavigation, aeDefault]</tt>: не ограничивайте использование сетки предопределенными размерами сетки для пользовательского интерфейса, подобного Excel
* <tt>EditorLineMode = elmMultiLine</tt>: Activate cell editor supporting multiple lines during editing.
+
* <tt>EditorLineMode = elmMultiLine</tt>: активируйте редактор ячейки, поддерживающий многострочность во время редактирования
* <tt>MouseWheelOption = mwGrid</tt>: The mouse wheel scrolls the grid, not the selected cell.
+
* <tt>MouseWheelOption = mwGrid</tt>: колесико мыши прокручивает сетку, а не выбранную ячейку
* <tt>Options</tt>: add these flags to the standard options inherited from TCustomGrid:
+
* <tt>Options</tt>: добавьте эти флаги в стандартные параметры, унаследованные от TCustomGrid:
** <tt>goColSizing</tt>: the user can change a column width by dragging the vertical separating line between two column header cells
+
** <tt>goColSizing</tt>: пользователь может изменить ширину столбца, перетащив вертикальную разделительную линию между двумя ячейками заголовка столбца
** <tt>goRowSizing</tt>: the user can change a row height by dragging the horizontal separating line between two row header cells
+
** <tt>goRowSizing</tt>: пользователь может изменить высоту строки, перетащив горизонтальную разделительную линию между двумя ячейками заголовка строки
** <tt>goDblClickAutosize</tt>: a double-click on a separating line between two column or row header cells resizes the column width or row height to its optimum value.
+
** <tt>goDblClickAutosize</tt>: двойной щелчок на разделительной линии между двумя ячейками заголовка столбца или строки изменяет ширину столбца или высоту строки до оптимального значения
** <tt>goEditing</tt>: puts the grid into edit mode (same as <tt>AutoEdit</tt>)
+
** <tt>goEditing</tt>: помещает сетку в режим редактирования (так же, как [и] <tt>AutoEdit</tt>)
** <tt>goThumbTracking</tt>: immediate scrolling of the grid while the scrollbar is dragged with the mouse (if this option is off scrolling occurs at the moment when the mouse button is released).
+
** <tt>goThumbTracking</tt>: немедленная прокрутка сетки, когда полоса прокрутки перетаскивается мышью (если эта опция отключена, прокрутка происходит в тот момент, когда кнопка мыши отпускается)
* <tt>TextOverflow = true</tt>: allow long cell text flow into empty adjacent cells
+
* <tt>TextOverflow = true</tt>: разрешить длинный поток текста ячейки в пустые соседние ячейки
  
== See also ==
+
== Смотри также ==
 
* [[FPSpreadsheet_tutorial:_Writing_a_mini_spreadsheet_application|FPSpreadsheet tutorial: Writing a mini spreadsheet application]]
 
* [[FPSpreadsheet_tutorial:_Writing_a_mini_spreadsheet_application|FPSpreadsheet tutorial: Writing a mini spreadsheet application]]
 
* [[FPSpreadsheet|API documentation of FPSpreadsheet]]
 
* [[FPSpreadsheet|API documentation of FPSpreadsheet]]
 
* [[RPN_Formulas_in_FPSpreadsheet|RPN formulas in FPSpreadsheet]]
 
* [[RPN_Formulas_in_FPSpreadsheet|RPN formulas in FPSpreadsheet]]
* [[FPSpreadsheet:_List_of_formulas|FPSpreadsheet: List of formulas]]
+
* [[FPSpreadsheet:_List_of_formulas/ru|FPSpreadsheet: List of formulas]]
* [[Grids_Reference_Page|Grids reference page]]
+
* [[Grids_Reference_Page/ru|Grids reference page]]

Latest revision as of 01:49, 2 March 2020

English (en) русский (ru)


-- Zoltanleo 15:36, 21 September 2018 (CEST) Ввиду сложности дословного перевода текста с английского на русский слова, требующиеся по смыслу, но отсутствующие в английской версии, указаны в квадратных скобках.



Обзор

TsWorksheetGrid - это специализированный компонент сетки, который взаимодействует с TsWorksheet из библиотеки FPSpreadsheet и отображает файлы данных электронных таблиц, как обычный TStringGrid.

fpsgrid.png

Интерфейс программирования

TsWorksheetGrid наследуется от TCustomGrid и ведет себя как стандартный TStringGrid. Основное различие заключается в том, что сама сетка не хранит данные, но данные хранятся в TWorksheet из FPSpreadsheet. Доступ к рабочему листу можно получить с помощью свойства Worksheet сетки. Аналогично, Workbook позволяет получить доступ ко всей рабочей книге, к которой принадлежит рабочий лист.

Для доступа к ячейкам, их значениям и атрибутам доступно множество свойств, как и в случае StringGrid, например, запись значения ячейки с помощью Grid.Cells[ACol, ARow] := 1.234. Ячейки идентифицируются в этих свойствах с помощью индексов столбцов и строк ячейки. Обратите внимание, что индексы передаются в порядке "первый столбец/последняя строка" и включают индексы, занятые фиксированными ячейками, т.е. верхняя/левая ячейка данных имеет индексы col=1 и row=1. Это отличается от fpspreadsheat, где индексы всегда начинаются с 0 и передаются в функции в обратном порядке "первая строка/последний столбец".

Доступ к значениям ячеек

Свойство Cells[ACol, ARow] обеспечивает доступ к данным в ячейке, заданной его индексами столбцов и строк. Это похоже на TStringGrid. В отличие от TStringGrid, который работает только со строками, TsWorksheetGrid, принимает числа, даты, булевы типы и формулы. По этой причине тип данных Cells является variant.

Запись значений ячеек

Используйте этот код для записи данных в ячейку в TsWorksheetGrid с именем Grid для простоты:

  // Записываем строку
  Grid.Cells[1, 1] := 'Это - строка';  
  // Записываем строку со встроенными кодами HTML
  Grid.Cells[1, 2] := 'Химическая формула <b>воды</b>: H<sub>2</sub>O';
  // Записываем число
  Grid.Cells[1, 3] := 1.2345;
  // Записываем дату
  Grid.Cells[1, 4] := EncodeDate(2016, 1, 18);
  // Записываем формулу
  Grid.Cells[1, 5] := '=A3+2';
  // и т.д.
Light bulb  Примечание: Текст, назначенный ячейке, может содержать встроенные простые HTML-коды для изменения шрифта для определенных слов или символов.

Чтение значений ячеек

Точно так же значения ячеек можно считывать в переменные выделенных типов:

var
  str: String;
  x: Double;
begin
  str := Grid.Cells[1, 1];  // Переменная "str" будет содержать значение "Это  - строка",
  x := Grid.Cells[1, 2];    // x будет 1.2345
  str := Grid.Cells[1, 2];  // Хотя ячейка содержит число, она преобразуется в строку "1.2345"
end;

Сравнение значений ячеек

Так как свойство Cells является [типом] вариант, сравнение строки со строкой немного сложнее. Используйте функцию преобразования строк в вариант VarToStr(), предоставляемую модулем variant.

  // Это простое сравнение не удастся:
  // if Grid.Cells[1,1] = 'Это - строка' then ...

  // Используйте вместо этого:
  if VarToStr(Grid.Cells[1,1]) = 'Это - строка' then ...

Численные значения часто можно сравнивать без явного преобразования:

  if Grid.Cells[1,2] = 1.2345 then ...

Формулы в ячейках

Поскольку TsWorksheetGreed работает поверх электронной таблицы, могут быть вводиться все формулы, поддерживаемые FPSpreadsheet. См. этот документ для полного списка поддерживаемых формул.

Строка формулы должна начинаться с символа «=». Ссылки на ячейки должны следовать за символом "A1" в обозначении Excel, то есть индексом столбца должны быть символы «A» .. «Z», а индекс строки - целое число, начинающее [нумерацию] с 1. Если имеется более 26 столбцов, можно использовать два (или три) символа.

В случае диапазона ячеек координаты верхних и нижних правых углов прямоугольника ячейки должны быть разделены цветом, напр., '=SUM(A1:C10)' вычисляет сумму значений в прямоугольнике ячейки, проходящих между A1 и C10.

Формулы, относящиеся к ячейкам других листов, можно использовать, следуя синтаксису Excel: укажите имя листа, за которым следует символ "!" перед адресом ячейки, напр., '=Sheet3!A1' или '=SUM(Sheet3:Sheet4!A1:C10)'.

Обратите внимание, что формулы по умолчанию автоматически не вычисляются. Чтобы активировать автоматический расчет формул, установите для свойства сетки AutoCalc значение true или установите опцию рабочей книги boAutoCalc, используемую сеткой. "Автоматический расчет" означает, что все формулы на всем листе пересчитываются всякий раз, когда изменяется содержимое любой ячейки. Поэтому не требуется, чтобы ячейки, адрессованные

формулой, имели значения при ее вводе.
// Включаем автоматический расчет формул
Grid.AutoCalc := true;        
// or: Grid.Workbook.Options := Grid.Workbook.Options + [boAutoCalc];

// Вводим ячейки
Grid.Cells[1,1] := 1;         // это - ячейка A1
Grid.Cells[1,2] := 2;         // это - ячейка A2

// Вводим формулу
Grid.Cells[1,3] := '=A1+A2';  // Вычисляем сумму значений в A1 и A2 

// Другая формула в ячейке B3
Grid.Cells[2,3] := '=B1*B2';  // Не имеет значения, что ячейки B1 и B2 еще не существуют.

// Вводим ячейки, необходимые по формуле
Grid.Cells[2,1] := '=A3';     // Используем результат предыдущей формулы
Grid.Cells[2,2] := 10;

Форматирование ячеек

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

  • BackgroundColor[ACol, ARow: Integer]: TsColor - задает цвет фона ячейки. TsColor - целое число, содержащее [значение] rgb-составляющей цвета. Модуль fpsTypes предоставляет список констант для большого количества предопределенных цветов; могут использоваться цвета, определенные стандартным модулем Graphics (за исключением значений цвета системы).
  • CellBorder[ACol, ARow: Integer]: TsCellBorders - указывает, какие края ячеек будут обозначены рамкой. Используйте установленные значения [cbEast, cbWest, cbNorth, cbSouth] для правого, левого, верхнего и нижнего краев соответственно.
  • CellBorderStyle[ACol, ARow: Integer; ABorder: TsCellBorder]: TsCellBorderStyle - указывает стиль, который будет использоваться для линии границы ячейки, указанной в параметре ABorder. TsCellBorderStyle - это запись, содержащая информацию о стиле линии и цвете линии. Обратите внимание, что набор CellBorder[ACol, ARow] должен содержать элемент ABorder, чтобы активировать эту границу.
  • CellFont[ACol, ARow: Integer]: TFont - описывает шрифт, используемый при прорисовке текста ячейки. Элементы шрифта могут быть изменены отдельно этими свойствами:
    • CellFontColor[ACol, ARow: Integer]: TsColor - определяет цвет текста. См. "BackgroundColor" выше для [получения] описания типа TsColor.
    • CellFontName[ACol, ARow: Integer]: String - это имя шрифта.
    • CellFontSize[ACol, ARow: Integer]: Single - это размер точки шрифта (1 pt = 1/72 дюйма).
    • CellFontStyle[ACol, ARow: Integer]: TsFontStyles - представляет собой набор, содержащий элементы для использования жирного шрифта, курсива, подчеркнутого или зачеркнутого шрифтов.
  • HorAlignment[ACol, ARow: Integer]: TsHorAlignment - позволяет изменять горизонтальное выравнивание текста ячейки (haLeft, haCenter, или haRight).
  • NumberFormat[ACol, ARow: Integer]: String - представляет собой строку формата номера, совместимую с Excel, например. '0.000' для отображения числового значения с 3 десятичными знаками. Формат чисел важен, если цифры должны отображаться как значения даты или времени.
  • TextRotation[ACol, ARow: Integer]: TsTextRotation - должен использоваться для поворота текста внутри ячейки. Тип TsTextRotation обеспечивает [ориентацию] trHorizontal [(по горизонтали, по умолчанию)], rt90DegreeClockwiseRotation [(на 90° по часовой стрелке)], rt90DegreeCounterClockwiseRotation [(на 90° против часовой стрелки)] и rtStacked [(символов, располагающихся друг над другом, подобно японским иероглифам)].
  • VertAlignment[ACol, ARow: Integer]: TsVertAlignment - позволяет изменять горизонтальное выравнивание текста ячейки (vaTop [(по верхнему краю)], vaCenter [(по центру)] или vaBottom [(по нижнему краю)]).
  • Wordwrap[ACol, ARow: Integer]: Boolean - активирует автоперенос строки текста, длина которой больше ширины ячейки (или высота, если используется повернутый текст).

Эти свойства также могут быть доступны для диапазона ячеек, указанных индексами левого столбца, верхней строки, правого столбца и нижней строки блока ячейки. Поскольку эти свойства связаны с несколькими ячейками, они пишутся во множественном числе (с окончанием "s"):

  • BackgroundColors[ALeft, ATop, ARight, ABottom: Integer]: TsColor
  • CellBorders[ALeft, ATop, ARight, ABottom: Integer]: TsCellBorders
  • CellBorderStyles[ALeft, ATop, ARight, ABottom: Integer; ABorder: TsCellBorder]: TsCellBorderStyle
  • CellFonts[ALeft, ATop, ARight, ABottom: Integer]: TFont
  • CellFontColors[ALeft, ATop, ARight, ABottom: Integer]: TsColor
  • CellFontNames[ALeft, ATop, ARight, ABottom: Integer]: String
  • CellFontStyles[ALeft, ATop, ARight, ABottom: Integer]: TsFontStyles
  • CellFontSizes[ALeft, ATop, ARight, ABottom: Integer]: Single
  • HorAlignments[ALeft, ATop, ARight, ABottom: Integer]: TsHorAlignment
  • NumberFormats[ALeft, ATop, ARight, ABottom: Integer]: String
  • TextRotations[ALeft, ATop, ARight, ABottom: Integer]: TsTextRotation
  • VertAlignments[ALeft, ATop, ARight, ABottom: Integer]: TsVertAlignment
  • Wordwraps[ALeft, ATop, ARight, ABottom: Integer]: Boolean

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


Примеры

Этот пример добавляет формулу для сегодняшней даты в ячейку A1, форматирует ячейки для отображения числа в качестве даты и выбирает белый шрифт курсивом на светло-сером фоне. Вокруг ячейки пунктиром рисуется красная рамка.

const
  RED_DOTTED_BORDER: TsBorderStyle = (LineStyle: lsDotted; Color: scRed);

// Задаем содержимое ячейки
Grid.Cells[1,1] := '=TODAY()';

// Форматируем [содержимое] как дату
Grid.Numberformat[1,1] := 'yyyy/mm/dd';

// Выбираем цвет фона [сетки]
Grid.BackgroundColor[1,1] := scSilver;

// Выбираем [цвет и стиль] шрифта 
Grid.FontColor[1,1] := scWhite;
Grid.FontStyle[1,1] := [fssItalic];

// Прорисовываем границы ячейки 
Grid.Border[1,1] := [cbEast, cbWest, cbNorth, cbSouth];

// Определяем, как будут нарисованы границы ячеек
Grid.BorderStyle[1,1, cbEast] := RED_DOTTED_BORDER;
Grid.BorderStyle[1,1, cbWest] := RED_DOTTED_BORDER;
Grid.BorderStyle[1,1, cbNorth] := RED_DOTTED_BORDER;
Grid.BorderStyle[1,1, cbSouth] := RED_DOTTED_BORDER;

[Процесс] определения границ ячеек для более крупного блока ячеек с помощью этих свойств [вручную] будет довольно громоздким, потому что могут использоваться различные стили для внутренних, внутренних и внутренних ячеек. Чтобы решить эту задачу проще, сетка предоставляет метод ShowCellBorders, который получает координаты блока ячейки и стили левой, верхней, правой, нижней внешней и горизонтальной и вертикальной внутренних линий границы. Используйте константу NO_CELL_BORDER, при которой граница не должна быть выделена в определенном месте:

const
  THICK_CELL_BORDER: TsCellBorderStyle = (LineStyle: lsThick; Color: clBlack);
  DOTTED_CELL_BORDER: TsCellBorderStyle = (LineStyle: lsDotted; Color: clSilver);

// Нарисуем толстую рамку вокруг блока A1:C3, без внутренней границы
Grid.ShowCellBorders(1,1, 3,3,      // левая, верхняя, правая, нижняя координаты блока ячеек
  THICK_CELL_BORDER, THICK_CELL_BORDER, THICK_CELL_BORDER, THICK_CELL_BORDER,   // стили внешней границы
  NO_CELL_BORDER, NO_CELL_BORDER                                                // стили внутренней границы
);

// Нарисуйте толстую рамку вокруг блока A1: C3, серые горизонтальные внутренние линии пунктиром
Grid.SetCellBorders(1,1, 3,3, 
  THICK_CELL_BORDER, THICK_CELL_BORDER, THICK_CELL_BORDER, THICK_CELL_BORDER, 
  DOTTED_CELL_BORDER, NO_CELL_BORDER
);

Комментарии ячейки

Комментарии могут быть добавлены в каждую ячейку с использованием свойства сетки CellComment[ACol, ARow: Integer]: String. Ячейки, содержащие комментарий, отмечены красным треугольником в верхнем правом углу ячейки. Если мышь перемещается в ячейку с комментарием, появляется всплывающее окно для отображения комментария.

Light bulb  Примечание: Чтобы всплывающее окно появилось, необходимо добавить флаг goCellHints в свойство Options сетки, а стандартное свойство сетки ShowHint должно [иметь значение] true. В противном случае всплывающие окна не будут отображаться.

Пример:

Grid.Cells[1,1] := '=pi()';
Grid.CellComment[1,1] := 'Число pi необходимо для вычисления площади и окружности круга.';

Гиперссылки в ячейках

Ячейки с прикрепленными гиперссылками позволяют пользователю перемещаться по другим ячейкам или другим документам [простым] нажатием на ячейку. Доступ к гиперссылкам можно получить с помощью свойства Hyperlink[ACol, ARow: Integer]: String. Строка гиперссылки содержит цель гиперссылки и необязательный текст всплывающей подсказки, который разделяется символом штриха ("|"). Внутренние цели уже обрабатываются сеткой, но для навигации у гиперссылки должен быть определен обработчик событий для OnClickHyperlink. Чтобы отличить нормальные клики по ячейкам от кликов по гиперссылкам, кнопка мыши должна удерживаться доли секунды до того, как будет [выполнен переход по] гиперссылке.

Пример:

// Пример добавления внешней гиперссылки
Grid.Cells[1,1] := 'Lazarus';
Grid.Hyperlink[1,1] := 'www.lazarus-ide.org|Открыть веб-сайт Lazarus';

// Пример добавления внутренней гиперссылки
Grid.Cells[2,2] := 'Итого';
Grid.Hyperlink[2,2] := '#Sheet2!B10|Перейдите к итогам, начиная с ячейки B10 листа 2';

// Пример для обработчика событий OnClickHyperlink, необходимого для внешних гиперссылок
uses
  ..., uriparser;

procedure TForm1.GridOnClickHyperlink(Sender: TObject; const AHyperlink: TsHyperlink);
begin
var
  uri: TUri;
begin
  uri := ParseURI(AHyperlink.Target);
  case Lowercase(uri.Protocol) of
    'http', 'https', 'ftp', 'mailto', 'file':
      OpenUrl(AHyperlink.Target);
    else
      ShowMessage('Гиперссылка ' + AHyperlink.Target + ' нажата');
  end;
end;
Light bulb  Примечание: Следуйте инструкциям выше, чтобы отобразить текст всплывающей подсказки в виде всплывающего окна.

Объединенные ячейки

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

Используйте метод MergeCells для выполнения этой операции. В качестве параметров требуется объединить левую, верхнюю, правую и нижнюю координаты диапазона ячеек. Они также могут быть объединены в запись TRect. Метод Unmerge снова разделяет ранее объединенный блок на отдельные ячейки, здесь достаточно координат одной ячейки из объединенного диапазона.

  // Пример слияния
  Grid.MergeCells(1,1, 3,1);          // Объединяем первые 3 ячейки первой строки
  Grid.Cells[1,1] := 'Итого';         // Записываем текст "Итого" по 3 ячейкам
  Grid.HorAlignment[1,1] := haCenter; // и центрируем его

  // Пример разделения
  Grid.UnmergeCells(1,1);             // Разделяем объединенный блок (1,1..3,1)

Ширина столбцов и высота строк

Column widths and row heights can be changed for all cells by setting the DefaultColWidth and DefaultRowHeight. This works also in design mode. In addition, the widths and heights of particular columns and rows can be modified by the properties ColWidths[ACol] and RowHeights[ARow]. These values must be given in pixels.

Ширину столбцов и высоту строк можно изменить для всех ячеек, определив [свойства] DefaultColWidth и DefaultRowHeight. Это работает также в режиме разработки. Кроме того, ширина и высота отдельных столбцов и строк могут быть изменены свойствами ColWidths[ACol] и RowHeights[ARow]. Эти значения должны указываться в пикселях.

  Grid.DefaultColWidth := 80;  // Это ширина всех столбцов, 
  Grid.ColWidths[10] := 10;    // исключая столбец #10, ширина которого составляет всего 10 пикселей.

  Grid.DefaultRowHeight := 20; // Все строки имеют высоту 20 пикселей,
  Grid.RowHeights[2] := 4;     // Строка #2 служит в качестве разделителя и имеет высоту всего 4 пиксела.

Новые свойства сетки

В дополнение к свойствам, унаследованным от его предков TCustomDrawGrid и TCustomGrid, TsWorksheetGrid вводит следующие новые published-свойства:

  • AllowDragAndDrop (boolean): если эта опция активна, ячейки можно перетащить в новое место. Переместите курсор мыши на границу ячеек, которые нужно перетащить, пока курсор мыши не станет четырехсторонней стрелкой, а затем начинайте перетаскивание. Если перетаскиваемая ячейка ссылается на формулу, формула НЕ обновляется - это поведение отличается от Excel, но согласуется с Open/LibreOffice Calc.
  • AutoCalc (boolean): формулы в сетке автоматически пересчитываются при изменении содержимого ячейки.
  • AutoExpand (set of aeData, aeNavigation, aeDefault):
    • Если опция aeData содержится в наборе AutoExpand, тогда сетка автоматически расширяется, если ячейки записываются за пределами предопределенного диапазона.
    • Если AutoExpand содержит параметр aeNavigation, тогда пользователь может перемещаться за пределами предопределенного диапазона ячеек; новые строки и столбцы автоматически добавляются в сетку (но не к основному листу). Если файл загружен в сетку, то размеры сетки автоматически расширяются до диапазона, необходимого для рабочего листа.
    • Опция aeDefault вступает в игру, если сетка меньше значений по умолчанию DEFAULT_COL_COUNT и DEFAULT_ROW_COUNT. Если этот параметр включен, сетка автоматически расширяется до этого размера по умолчанию [(с добавлением "недостающих" столбцов и строк)]. С другой стороны, если в сетке должно содержаться только определенное количество строк и столбцов, опция aeDefault должна быть удалена до установки [свойств] RowCount/ColCount.
  • EditorLineMode определяет, поддерживает ли редактор ячейки сетки только одиночные строки (elmSingleLine) или несколько строк (elmMultiLine). В последнем случае вы можете нажать CTRL + ENTER, чтобы начать новую строку во время редактирования ячейки.
  • FrozenBorderPen: если сетка имеет замороженные панели (см. FrozenCols и FrozenRows), разделительная линия вытягивает край последней замороженной строки и столбца , Свойство FrozenBorderPen определяет способ рисования этой строки. Установите [значение свойства] FrozenBorderPen.Style = psClear, чтобы скрыть эти линии.
  • FrozenCols и FrozenRows (integer): определяет количество НЕ прокручиваемых столбцов(строк) слева(сверху) сетки. Технически это настраиваемые фиксированные столбцы (строки) предка. Обратите внимание, что пользователь не может перемещаться или редактировать ячейки в этом диапазоне.
  • ReadFormulas (boolean): считывает формулы из входных файлов. Так как fpspreadsheet не поддерживает все формулы, доступные в приложениях электронной таблицы Office, есть вероятность, что при чтении файла может произойти сбой из-за формул; в этом случае чтение формул может быть отключено.
  • SelectionPen (TPen): определяет, как окрашивается граница выбранной ячейки. По умолчанию выбранная ячейка выделена черной линией шириной 3 пикселя.
  • ShowGridLines (boolean): позволяет отключить линии сетки
  • ShowHeaders (boolean): может использоваться для отключения заголовков столбцов и строк ('A', 'B', 'C', ..., '1', '2', '3'). Свойство DisplayFixedColRow имеет тот же эффект, но теперь устарело.
  • TextOverflow (boolean): если это свойство включено, то длинному текстовому контенту разрешается распространяться на соседние ячейки, если они пусты. Обратите внимание, что ячейки числовых данных округлены так, что ячейка не переполняется.
  • WorkbookSource (TsWorkbookSource): ссылки на источник рабочей книги, которые предоставляют данные. Если [ссылки] пустые, сетка использует внутренний источник рабочей книги.

События

  • OnClickHyperlink: это событие срабатывает всякий раз, когда пользователь нажимает на ячейку со встроенной гиперссылкой. Поскольку щелчок по ячейке обычно приведет к переключению ячейки в режим редактирования, необходимо удерживать клавишу мыши примерно на полсекунды, чтобы вызвать событие гиперссылки.

Рекомендуемые значения свойств

Чтобы настроить сетку для работы аналогично хорошо известным приложениям Office, мы рекомендуем следующие настройки свойств сетки. Следует, однако, подчеркнуть, что различия в использовании существуют и не могут быть удалены без серьезной перезаписи унаследованной инфраструктуры сетки:

  • AutoAdvance = aaDown: клавиша ENTER переводит [фокус] с выбранной ячейки в следующую нижнюю ячейку
  • AutoCalc = true: автоматическое вычисление формул
  • AutoEdit = true: для редактирования ячейки просто начинайте печатать. Кроме того, вы можете начать редактирование, нажав F2
  • AutoExpand = [aeData, aeNavigation, aeDefault]: не ограничивайте использование сетки предопределенными размерами сетки для пользовательского интерфейса, подобного Excel
  • EditorLineMode = elmMultiLine: активируйте редактор ячейки, поддерживающий многострочность во время редактирования
  • MouseWheelOption = mwGrid: колесико мыши прокручивает сетку, а не выбранную ячейку
  • Options: добавьте эти флаги в стандартные параметры, унаследованные от TCustomGrid:
    • goColSizing: пользователь может изменить ширину столбца, перетащив вертикальную разделительную линию между двумя ячейками заголовка столбца
    • goRowSizing: пользователь может изменить высоту строки, перетащив горизонтальную разделительную линию между двумя ячейками заголовка строки
    • goDblClickAutosize: двойной щелчок на разделительной линии между двумя ячейками заголовка столбца или строки изменяет ширину столбца или высоту строки до оптимального значения
    • goEditing: помещает сетку в режим редактирования (так же, как [и] AutoEdit)
    • goThumbTracking: немедленная прокрутка сетки, когда полоса прокрутки перетаскивается мышью (если эта опция отключена, прокрутка происходит в тот момент, когда кнопка мыши отпускается)
  • TextOverflow = true: разрешить длинный поток текста ячейки в пустые соседние ячейки

Смотри также