Часть 4. Calc
4.1 Основы работы с OpenOffice.Calc
Для того, чтобы начать работу с документом Calc, по аналогии с Writer'ом надо получить указатели вначале на листы, потом на конкретный лист и только потом на ячейку или диапазон ячеек. Таким образом, схема взаимодействия такова: ServiceManager -> Desktop -> Document -> Sheets -> Sheet -> Cell (Cells).
Получить все листы можно таким образом:
Sheets := Document.GetSheets
Сделать это можно, например, при открытии файла. Отмечу, что переменные Sheets, Sheet, Cell объявлены как Variant.
После того, как мы получили указатель на все листы, надо получить указатель на конкретный лист. Сделать это можно либо по его индексу:
Sheet := Sheets.getByIndex(Index);
либо по имени:
Sheet := Sheets.getByName('Sheet_Name').
Определим процедуру, которая устанавливает текущий лист по его индексу (листинг 12).
Листинг 12
procedure TOpenOffice.GetSheet(const Index :Word);
begin
Sheet := Sheets.getByIndex(Index);
end;
|
4.2 Запись в ячейку по ее координатам
Теперь можно получать указатель на конкретную ячейку или группу ячеек и работать с ними. Для записи данных в ячейку есть три метода, название которых говорит само за себя:
1.setValue;
2.setString;
3.setFormula.
Соответственно, первый вставляет число, второй – строку, третий – формулы. Чтобы получить значение, которое храниться в ячейке, надо в начале определить ее тип с помощью метода Cell.getType. Результатом работы будет одно из следующих значений:
1.0 – ячейка пуста;
2.1 – в ячейке число;
3.2 – строка;
4.3 - формула.
После этого можно узнать значение, для этого в зависимости от результата работы метода getType надо вызвать методы соответственно: getValue, getString, getFormula.
Единственное, что мы не сделали – не получили указатель на ячейку. Сделать это можно несколькими способами, в зависимости от цели. В листинге 13 приведен пример записи в ячейку текста, ячейка задается своими координатами.
Листинг 13
procedure TOpenOffice.InsertTextByCoord(const Text: String; col:integer; row:integer);
begin
Cell := Sheet.getCellByPosition(col, row);
Сell.setString(Text);
end;
|
В данном случае мы получаем ячейку по ее координатам:
Cell := Sheet.getCellByPosition(col, row).
Потом записываем в эту ячейку текст.
4.3 Запись в ячейку по метке
Разобравшись с простым, перейдем к главному – работе с метками. Некоторые основы мы уже разобрали при работе с Writer'ом. Теперь будет легче. В листинге 14 приведен пример вставки текста в ячейку, которая задается меткой.
Листинг 14
procedure TOpenOffice.InsertTextByName(const Text: String; Name: String);
var
i:boolean;
j:integer;
Perem :longint;
begin
Perem:=0;
Perem:=Sheets.getCount;
j:=0;
repeat
i:=True;
Sheet := Sheets.getByIndex(j);
try
Sheet.getCellRangeByName(Name);
except
j:=j+1;
i:=False;
Perem:=Perem-1;
end;
until (i or (Perem=1));
if(Perem=1) then ShowMessage('Нет такой метки')
else
begin
Cell:=Sheet.getCellRangeByName(Name);
Cell.setString(Text);
end;
end;
|
Разберемся подробнее. Переменная i:boolean – флаг для проверки метки на ее существование. j – счетчик для цикла проверки. Perem – количество листов в книге, которое мы можем получить с помощью метода getCount, вызванного для Sheets. Вначале мы устанавливаем указатель конкретного листа Sheet на первый лист в книге. И пытаемся найти метку, заданную именем Name на этом листе:
try
Sheet.getCellRangeByName(Name).
Если метки нет, то мы просто устанавливаем активным следующий лист и проверяем дальше пока не найдем такую метку или пока поймем, что такой метки нет (тогда выдается сообщение об ошибке). Если мы эту метку найдем, то записываем туда текст:
Cell.setString(Text).
На этом работа этой функции заканчивается.
4.4 Запись массива в диапазон ячеек
Теперь будем работать с группой ячеек. Для примера рассмотрим вставку массива из четырех элементов в группу из четырех ячеек. Процедура приведена в листинге 15.
Листинг 15
procedure TOpenOffice.InsertTableByName(Text1:String; Text2:String; Text3:String; Text4:String; Name:String);
const Bounds:array[1..4] of integer = (1,2,1,2);
var
VariantArray:Variant;
i:boolean;
j:integer;
Range: Variant;
Perem :longint;
begin
VariantArray := VarArrayCreate(Bounds, varVariant);
Perem:=0;
Perem:=Sheets.getCount;
VariantArray[1,1]:=Text1;
VariantArray[1,2]:=Text2;
VariantArray[2,1]:=Text3;
VariantArray[2,2]:=Text4;
j:=0;
repeat
i:=True;
Sheet := Sheets.getByIndex(j);
try
Sheet.getCellRangeByName(Name);
except
j:=j+1;
i:=False;
Perem:=Perem-1;
end;
until (i or (Perem=1));
if(Perem=1) then ShowMessage('Нет такой метки')
else
begin
Range:=Sheet.getCellRangeByName(Name);
Range.setDataArray(VariantArray);
end;
end;
|
Параметрами этой процедуры являются четыре элемента, котрые мы должны вставить в ячейки, а также имя метки (Name), присвоенной диапазону ячеек. В начале мы создаем массив из четырех элементов и присваиваем им значения, которые мы передали функции.
VariantArray := VarArrayCreate(Bounds, varVariant);
VariantArray[1,1]:=Text1;
VariantArray[1,2]:=Text2;
VariantArray[2,1]:=Text3;
VariantArray[2,2]:=Text4;
|
Далее идет проверка на наличие метки в открытом документе, эта часть кода полностью повторяет код из листинга 14. Понятно, что ее можно выделить в отдельную функцию, что и было сделано (листинг 17).
Разница есть в методе записи массива. Делается это с помощью метода setDataArray. Аргументом этого метода является ранее созданный массив из четырех элементов.
4.5 Форматирование группы ячеек
Теперь рассмотрим функцию форматирования группы ячеек (листинг 16).
Листинг 16
procedure TOpenOffice.RangeFormat(Name:String; FontName:String;
FontSize, FontType, FontColor, BackColor:longint);
var
font: TFont;
Range: Variant;
begin
Range:=GetRange(Name);
if FontName <> '' then Range.charFontName:=FontName;
if FontSize <> 0 then Range.charHeight:=FontSize;
if FontType <> -1 then
begin
if(FontType and $04)=4 then
Range.charWeight:=fsBold else
Range.charWeight:=0;
if(FontType and $02)=2 then
Range.charPosture:=fsItalic else
Range.charPosture:=0;
if(FontType and $01)=1 then
Range.charUnderline:=fsUnderline else
Range.charUnderline:=0;
end;
if FontColor <> -1 then
Range.charColor:=FontColor;
if BackColor <> -1 then
Range.cellBackColor:=BackColor;
end;
|
В этой процедуре используется метод GetRange, текст которого приведен в листинге 16. Этот метод просто возвращает указатель на группу ячеек.
Разберемся в параметрах, которые передаются этой функции. Name:String – имя присвоенной метки; FontName:String – имя шрифта; FontSize – размер шрифта; FontType – тип шрифта (жирный, курсив, подчеркнутый); FontColor – цвет шрифта в формате RGB; BackColor – цвет фона в формате RGB.
После получения указателя на диапазон ячеек мы проверяем параметры и устанавливаем новые свойства для этого диапазона. Если мы ввели новое имя шрифта, тогда мы устанавливаем этот шрифт для диапазона ячеек Name с помощью метода charFontName:
Range.charFontName:=FontName
Точно также устанавливаем новый размер шрифта с помощью метода charHeight:
Range.charHeight:=FontSize;
Теперь рассмотрим установку FontType. Вариантов значения параметра FontType может быть всего 8:
1.0 – тогда шрифт остается стандартным;
2.1 – тогда шрифт подчеркнутый;
3.2 – курсив;
4.3 – подчеркнутый + курсив;
5.4 – жирный;
6.5 – жирный + подчеркнутый;
7.6 – жирный + курсив;
8.7 – жирный + подчеркнутый + курсив.
Таким образом, мы делаем побитовую конъюнкцию FontType с константами 1, 2 и 4 и определяем тип шрифта, который нужно установить. Например, курсив устанавливаем так:
Range.charPosture:=fsItalic.
С цветом шрифта и цветом фона поступаем аналогично, за их установку отвечают методы CharColor и CellBackColor:
Range.charColor:=FontColor
Range.cellBackColor:=BackColor
Листинг 17
function TOpenOffice.GetRange(Name: String): Variant;
var
i: integer;
Sheet: Variant;
begin
for i := 0 to Sheets.getCount - 1 do
try
Sheet := Sheets.getByIndex( i );
Result := Sheet.getCellRangeByName( Name );
if not ( VarIsEmpty(Result) or VarIsNull(Result)) then
Exit;
except
Result := Null;
end;
end;
|
|
OpenOffice.org
