уважаемые посетители блога, если Вам понравилась, то, пожалуйста, помогите автору с лечением. Подробности тут.
Сегодня, в последний рабочий день недели, практически весь день провозился над передачей данных из Delphi в Word. Так как подозрение есть, что работа продолжится то решил кое-какие моменты по работе с Microsoft Word в Delphi запечатлеть и у себя в блоге. Написать такую мини-шпаргалку (тем более, что по Excel уже кое что есть).
Для начала, немного общих моментов по работе с MS Office в Delphi. И первое, что мы сделаем — это создадим объект Word.Application. Создается этот объект абсолютно также, как и объект Excel.Application:
uses ComObj; var Word: variant; [...] procedure CreateWord(const Visible: boolean); begin Word:=CreateOleObject('Word.Application'); Word.Visible:=Visible; end;
Всё достаточно просто. Далее мы можем работать с объектом следующим образом:
- Создавать документ Word с нуля
- Открыть уже существующий документ и изменить в нем текст для получения необходимой формы документа.
Рассмотрим оба варианта, т.к. оба они имеют как свои плюсы, так и недостатки.
Чтобы создать новый документ необходимо выполнить метод Add у коллекции Documents, т.е.:
[...] Word.Documents.Add [...]
и после этой операции уже начинать работать с документам обращаясь к нему по индексу или имени в коллекции. Также, можно создать новый документ по шаблону (*.dot). Для этого необходимо выполнить тот же метод Add, но с одним входным параметром — путем к файлу-шаблону:
[...] Word.Documents.Add(TamplatePath:string); [...]
Чтобы получить список всех открытых в данный момент документов Word можно воспользоваться следующим листингом:
[...] var List: TStringList; i: integer; begin List:=TStringList.Create; for i:=1 to Word.Documents.Count do List.Add(Word.Documents.Item(i).Name); end; [...]
Обратите внимание, что нумерация начинается с 1, а не с нуля. Чтобы активировать любой документ из коллекции для работы, необходимо выполнить метод Activate:
Word.Documents.Item(index).Activate
где index — номер документа в коллекции.
Теперь можно приступать к записи и чтению документа. Для работы с текстов в документе Word, как и в Excel для работы с ячейками таблицы, определен объект Range. Именно методы этого объекта и дают нам возможность работы с текстом. Для начала рассмотрим работу двух основных методов: InsertBefore и InsertAfter.
Как следует из название — первый метод вставляет текст в начало содержимого Range, а второй — в конец. При этом сам объект Range может содержать как весть документ (Document) так и какую-либо его часть. Например, в следующем листинге я вставлю строку в начало документа и затем методом InsertAfter буду добавлять несколько строк текста в конец документа:
[...] Word.ActiveDocument.Range.InsertBefore('Hello World'); Word.ActiveDocument.Range.InsertAfter('текст после Hello World'); Word.ActiveDocument.Range.InsertAfter('окончание строки в документа'); [...]
При выполнении этих трех операции Range содержал весь документ.
Если работать со всем документом неудобно, а необходимо, например выделить фрагмент с 50 по 100 символ и работать с ним, то можно воспользоваться функцией Range, которая вернет нам необходимый объект Range:
var MyRange: variant; begin MyRange:=WordActiveDocument.Range(50,100); MyRange.InsertBefore('Привет');//всё, что было после 50-го символа сдвинулось вправо end;
Это что касается записи текста. Решение обратной задачи — чтения текста из документа ещё проще. Достаточно воспользоваться свойством Text у объекта Range:
[...] ShowMessage(Word.ActiveDocument.Range.Text) //весь текст в документе [...]
Также для чтения документа можно воспользоваться коллекцией документа Words (слова). За слово принимается непрерывный набор символов — цифр и букв, который оканчивается пробелом.
Перечисляются слова документа точно также как и при работе с коллекцией документов, т.е. первое слово имеет индекс 1 последнее — Word.Count.
[...] ShowMessage(Word.ActiveDocument.Words.Item(Word.ActiveDocument.Words.Count).Text) [...]
В данном случае я вывел на экран последнее слово в документе.
Очевидно, что приведенный выше способ работы с документам хорош в случае, когда требуется создать относительно простой документ Word и не требуется лишний раз рассчитывать фрагменты текста, правильно вставлять таблицы и т.д. Если же необходимо работать с документами, которые имеют сложное содержание, например текст в перемежку с рисунками, таблицами, а сам текст выводится различными шрифтами, то, на мой взгляд наиболее удобно использовать второй способ работы с Word в Delphi — просто заменить текст в уже заранее заготовленном документа.
2. Работа с документами Word в Delphi. Открытие готового документа и замена текста.
Чтобы открыть заранее заготовленный документ Word в Delphi достаточно воспользоваться методом Open у коллекции Documents, например так:
var FilePath: string; [...] Word.Documents.Open(FilePath) [...]
Метод Open можно вызывать с несколькими аргументами:
- FileName: string — путь и имя файла;
- ConfirmConversions: boolean — False — не открывать диалоговое окно «Преобразование файла» при открытии файла, формат которого не соответствует формату Word (doc или docx)
- ReadOnly:boolean — True — открыть документ в режиме «Только для чтения»
- AddToRecentFiles: boolean — True, чтобы добавить документ в список недавно открытых документов.
- PasswordDocument: string — пароль для открытия документа
- PasswordTemplate: string — пароль для открытия шаблона
- Revert : boolean — True, чтобы вернуться к сохраненному документу, если этот документ открывается повторно.
- WritePasswordDocument: string — пароль для сохранения измененного документа в файле
- WritePasswordTemplate:string — пароль для сохранения изменений в шаблоне
- Format:integer — формат открываемого документа.
Обязательным параметром метода Open является только FileName, остальные — могут отсутствовать. Если же Вам необходимо воспользоваться несколькими параметрами, то их необходимо явно указывать при вызове метода, например:
[...] Word.Documents.Open(FileName:=FilePath, ReadOnly:=true) [...]
В этом случае документ открывается в режиме «Только для чтения». При таком способе вызова (с явным указанием аргументов) положение аргументов может быть произвольным.
Что касается последнего аргумента — Format, то он может принимать целочисленные значения (применительно к версиям Microsoft Word 2007 и выше) от 0 до 13. При этом, для того, чтобы открыть «родные» вордовские документы (doc) достаточно использовать значения 0 или 6.
Теперь, когда документ открыт его необходимо преобразовать. Обычно я делаю следующим образом: в тех местах документа, в которые необходимо вставить текст я расставляю либо закладки, либо простые строки текста, например, обрамленные символом $ или #. И затем просто выполняю поиск и замену подстрок следующим образом:
function FindAndReplace(const FindText,ReplaceText:string):boolean; const wdReplaceAll = 2; begin Word.Selection.Find.MatchSoundsLike := False; Word.Selection.Find.MatchAllWordForms := False; Word.Selection.Find.MatchWholeWord := False; Word.Selection.Find.Format := False; Word.Selection.Find.Forward := True; Word.Selection.Find.ClearFormatting; Word.Selection.Find.Text:=FindText; Word.Selection.Find.Replacement.Text:=ReplaceText; FindAndReplace:=Word.Selection.Find.Execute(Replace:=wdReplaceAll); end;
Приведенная выше функция позволяет провести поиск и замену текстового фрагмента во всём документе. Для того, чтобы ограничить возможности пользователя при работе с шаблоном документа я обычно ставлю на необработанный файл пароль, а после обработки — пароль снимаю и сохраняю документ с другим названием в необходимую директорию.
Вот, наверное, самые-самые простые методы работы с Word в Delphi. Кстати, пишу пост и, думаю, что у кого-то из читателей может возникнуть вопрос: причём тут Delphi в Internet и Word в Delphi? Честно говоря, приведенный выше фрагменты кода можно использовать для нужд в Internet с натяжкой, например, при автосоставлении небольших отчётов по чему-либо. А вообще, в недалеком будущем, есть в планах поразбираться с Тезаурусом Word и попробовать составить небольшой синонимайзер для собственных нужд — он-то и пригодится нам в Internet
3.1
8
голоса
Рейтинг статьи
уважаемые посетители блога, если Вам понравилась, то, пожалуйста, помогите автору с лечением. Подробности тут.
Delphi –
это один из самых популярных и эффективных инструментов разработки сложных
приложений и возможность интегрировать средства приложений MS Office в разрабатываемые в этой среде проекты.
Известно, что Word и Excel является OLE – объектом. Суть OLE технологии возможность из разрабатываемого
приложения (клиента) взаимодействовать с другими приложениями (серверами). Все
приложения Microsoft Office являются так называемыми «серверами
автоматизации». Microsoft Word, являясь сервером OLE, позволяет
подключаться к себе клиентам и использовать свои методы и свойства.
Работа с MS Word в Borland Delphi. Для
работы с Word
файлами нам потребуется библиотека ComObj, которая входит в стандартную поставку Borland Delphi. Подключается она в разделе Uses.
Для начала нужно подключиться
к Word серверу, другими
словами ещё называют инициализацией. Это происходит следующим образом:
Var
Application: Variant
Begin
Application:=createOLEObject(‘Word.Application’) ;
End;
Сначала вводим
вариантную переменную, затем создаем объект OLE ‘Word.Application‘, и присваиваем его этой
переменной. Эта процедура называется «создание экземпляра сервера».
Создав этот объект, мы затем программируем его свойства и методы.
После создания
экземпляра сервера, нужно либо создать новый документ, либо открыть уже
имеющийся.
Создание нового
документа. Создание документа
производится методом Add. Синтаксис метода:
Add
(Template, NewTemplate, DocumentType, Visible);
Все параметры метода – типа Variant необязательны.
Template |
Имя шаблона, по которому создается новый документ. |
NewTemplate |
Если использовать значение True, то новый документ открывается как шаблон. Значение |
DocumentType |
Может принимать одно из следующих значений констант |
Visible |
Управляет видимостью созданного документа. Если |
Так как все параметры являются
необязательными, то для создания нового документа по шаблону Normal метод можно применить без параметров:
Application.Documents.Add;
Открытие документа. Открытие существующего документа Word реализуется методом Open. Синтаксис метода:
Open (FileName,
ConfirmConversions, ReadOnly, AddToRecentFiles, PasswordDocument,
PasswordTemplate, Revert, WritePasswordDocument, WritePasswordTemplate, Format,
Encoding, Visible);
Кроме параметра FileName все остальные необязательны.
FileName |
В параметре указывается имя файла |
ConfirmConversions |
Если в значении этого параметра |
ReadOnly |
Указывая True, открываем документ только для чтения. |
AddToRecentFiles |
Устанавливая значение в True, позволяем добавлять имя открываемого файла в список |
PasswordDocument |
Пароль открываемого документа. |
PasswordTemplate |
Пароль открываемого шаблона. |
Revert |
Параметр, предусмотренный для |
WritePasswordDocument |
Пароль для сохраняемого документа. |
WritePasswordTemplate |
Пароль для сохраняемого шаблона. |
Format |
Конвертор WdOpenFormat: wdOpenFormatAllWord, wdOpenFormatAuto, wdOpenFormatDocument, wdOpenFormatEncodedText, wdOpenFormatRTF, wdOpenFormatTemplate, wdOpenFormatText, wdOpenFormatUnicodeText, wdOpenFormatWebPages. По умолчанию wdOpenFormatAuto. Необязательный |
Encoding |
Кодировка для просмотра документа, |
Visible |
Устанавливая True, предусматриваем видимое открытие документа. По |
Например, для открытия документа «c:1.doc» метод Open применяется как
Application.Documents.Open(‘c:/1.doc’);
Все элементы рассматриваемого OLE объекта являются так
называемыми коллекциями. Коллекция – это объект, содержащий
специфический набор методов и свойств. Коллекция похожа на динамический массив.
В ней содержится набор объектов, которые обычно имеют один тип. Вы можете
добавлять в нее элементы, удалять и получать их значения. Доступ к элементу
осуществляется либо по его порядковому номеру, либо по его имени. Например, все
открытые документы представляют собой коллекцию.
Обращение к документу. Обращение к открытому документу, как к элементу
набора коллекции, можно по порядковому номеру методом Item. Например, обращение ко второму документу будет выглядеть как:
Application.Documents.Item(2);
Нумерация всех элементов
в коллекции начинается с единицы, а не с нуля. Аналогичную операцию можно
осуществить еще как:
Application.Documents(2);
Для работы с документом,
его сначала нужно активизировать, т.е. передать ему фокус, подготовить для
редактирования или других операций. Активизирование документа производится
методом Activate. Для активизации документа, его нужно выбрать из коллекции
по его порядковому номеру:
Application.Documents.Item(2).Activate; или по имени файла
Application.Document(‘c:1.doc’).Activate;
К активному документу
можно обращаться, используя свойство ActiveDocument, например, закрыть
активный документ:
Application.ActiveDocument.Close;
Вставка текста в
документ. Далее по тексту мы в
основном будем манипулировать коллекций объектов Range, т.е. весь текст удобно будет
рассматривать как несколько непрерывных областей. Добавление текста
осуществляется следующим образом: сначала создается объект Range, представляющий собой непрерывную область
документа, затем методами этого объекта добавляется текст. Объект Range может объявляться как:
выражение. Range (начало области,
конец области);
Например, объявленный ниже объект Range1 охватывает собой первые 10 символов
второго документа.
Var
Range1:variant;
Begin
Range1:=Application.Documents(2).Range(1,10);
End;
В документе сначала
можно создавать абзацы, т.е. объекты Paragraphs, и затем объединять их
в области. К примеру, в начале активного документа методом Add объекта Paragraphs создаем новый абзац, затем на его основе создаем
объект Range1:
Var
Range1:variant;
Begin
Application.ActiveDocument.Paragraphs.Add;
Range1:=Application.ActiveDocument.Paragraphs.Item(1).Range;
End;
Вставка текста производится
двумя методами объекта Range: InsertAfter и InsertBefore. Синтаксис методов:
выражение. InsertAfter(текст);
Этим методом
производится вставка текста после начала объекта Range выражение. InsertBefore(текст), а этим – до.
При использовании этих
методов, в качестве параметра указать нужно только текст в апострофах. К
примеру, вызов двух операторов даст нам две строки: это вставленный текст InsertBefore и это текст InsertAfter:
Range1.InsertAfter(‘это текст InsertAfter ‘);
Range1.InsertBefore(‘это вставленный текст InsertBefore‘);
У объекта Range есть много полезных свойств. Например:
Свойство Font (шрифт), которое имеет свои подсвойства:
Font.Bold:=True – жирность шрифта
Font.Name:=»Arial» – название
шрифта
Font.Size:= 24 – размер шрифта
Font.Color:= clRed – цвет
шрифта
Font.Italic:= True – наклонность шрифта
Например, вставка жирной строки зеленого цвета:
Range1.Font.Bold:=True;
Range1.Font.Size:=14;
Range1.Font.Color:=clGreen;
Range1.InsertAfter(‘вставленная строка‘);
Объект типа Range можно форматировать. Например, следующей строкой содержимое
объекта Range выравнивается по центру:
Range1.ParagraphFormat.Aligment:=wdAlignParagrapfCenter;
Работа с Excel
файлами в Delphi. Для работы с Excel файлами в Delphi так же нужно подключить модуль ComObj в разделе Uses.
Для
начала нужно подключиться к Excel серверу, другими словами ещё называют инициализацией. Это происходит следующим
образом:
var
Excel: Variant;
Excel := CreateOleObject(‘Excel.Application‘);
Сначала вводим
вариантную переменную, затем создаем объект OLE ‘Excel.Application‘, и присваиваем его этой
переменной. Эта процедура называется «создание экземпляра сервера».
Создав этот объект, мы затем программируем его свойства и методы.
После создания экземпляра сервера, нужно либо создать новую книгу, либо
открыть уже имеющуюся.
Создание новой книги:
Excel.Workbooks.Add;
Открытие существующей книги (где путь – путь к файлу с расширением xls.):
Excel.Workbooks.Open[путь]; //(Excel.Workbooks.Open(‘c:2.xls‘));
Открытие существующей книги только для чтения:
Excel.Workbooks.Open[путь, 0,
True];
Excel.Workbooks.Open(‘c:2.xls’,0,true);
Закрытие Excel:
Excel.ActiveWorkbook.Close;
Excel.Application.Quit;
Отображаем или скрываем Excel на экране:
Excel.Visible := True;
Excel.Visible := False;
Печать содержимого активного листа Excel:
Excel.ActiveSheet.PrintOut;
Чтение/запись данных
в Excel.
Доступ к ячейке в текущей книге Excel можно осуществить следующим
образом:
// запись значения в
ячейку
Excel.Range[‘A2′]:=’Привет!’;
// чтение значения
из ячейки
s:=Excel.Range[‘A2’];
где A2 – адрес ячейки.
Или
используя стиль ссылок R1C1:
Excel.Range[excel.Cells[2, 2]]:=’Привет!’; где [2, 2] – координата
ячейки.
Вообще,
ячейке Excel можно присваивать любое значение (символьное, целое, дробное,
дата) при этом Excel установит форматирование в ячейке применяемое по
умолчанию.
Формат ячеек в Excel. Выделить (выбрать) группу ячеек для последующей работы можно так:
Excel.Range[Excel.Cells[1,
1],Excel.Cells[5, 3]].Select; либо
Excel.Range[‘A1:C5’].Select;
При этом
будет выделена область находящаяся между ячейкой A1 и C5.
После выполнения
выделения можно установить:
1) Объединение ячеек:
Excel.Selection.MergeCells:=True;
2) Перенос по
словам:
Excel.Selection.WrapText:=True;
3) Горизонтальное
выравнивание:
Excel.Selection.HorizontalAlignment:=3;
при
присваивании значения 1 используется выравнивание по умолчанию,
при 2 –
выравнивание слева,3 – по центру, 4 – справа.
4) Вертикальное
выравнивание
Excel.Selection.VerticalAlignment:=1;
присваиваемые
значения аналогичны горизонтальному выравниванию.
5) Граница
для ячеек:
Excel.Selection.Borders.LineStyle:=1;
При
значении 1 границы ячеек рисуются тонкими сплошными линиями. Кроме этого можно
указать значения для свойства Borders, например, равное 3. Тогда установится
только верхняя граница для блока выделения:
Excel.Selection.Borders[3].LineStyle:=1;
Значение свойства Borders задает различную комбинацию граней ячеек.В
обоих случаях можно использовать значения в диапазоне от 1 до 10.
Winsoft’s Direct Office is a nice third party solution which bypasses the middle-man – namely Word – to create, open, and save DOCX documents.
DOCX is a standardized file format. It can be read using Libre Office, SoftMaker’s TextMaker and on-line Google Docs.
Installation
Steps:
- Download the trial version
- Unzip doffice.zip
- Find Winsoft.DirectOffice.dll in .dofficeDelphi along with the corresponding licenses in dofficeLicenses
DirectOffice vs Word COM API: Less code
Using Direct Office, you can reduce the amount of steps, bloat and coding to access Word Documents. Take for example, a simple operation of opening a document:
Direct Office | Microsoft Word COM API | |
Create Document | Check if Word is Open or Not. If Word is not open, launch Word. |
|
– | Check if Document is Open or Not. If Document is not Open, Open it. |
|
– | Check if View is in correct mode (Print View, Draft View…) If not in correct view, change it accordingly. |
|
Append Page | Insert Page |
Using the Word COM API, this is at least 35 lines of code. This includes exception checks, querying Word, if Word Document is already opened or not.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 |
uses ComObj, ActiveX, Word2000, ShellApi; ... var MSWord: Variant; Doc_: variant; begin try // Check if Word is already opened? MsWord := GetActiveOleObject(‘Word.Application’); except try MsWord := CreateOleObject(‘Word.Application’); MsWord.Visible := True; except Exception.Create(‘Error’); end; end; // Enumate… is Document already opened? var iNo, iCount: integer; var sFilename: string; var bExists: boolean; sFilename := ‘yourdoc.doc’; bExists := false; iCount := MsWord.Documents.Count_; for iNo := 1 to iCount do begin begin if MsWord.Documents(iNo).Path = sFilename then begin Doc_ := MsWord.Documents(iNo); bExists := true; end; end; end; if not bExists then begin Doc_ := MsWord.Documents; Doc_.Open(sFilename); end; |
In DirectOffice, access to Word Documents is less than 4 lines of code on average.
var WordDocument: WordprocessingDocument; begin WordDocument := CoWordprocessingDocumentClass.Create(‘yourdocument.docx’, WordprocessingDocumentType_Document); end; |
DirectOffice vs Word COM API: Speed
What if I told you, you could create and save Word Documents between 110% to 500% faster than using Word itself?
for iNo := 1 to 10000 do begin para1 := Doc_.Content.Paragraphs.Add(EmptyParam); para1.Range.Text := ‘Hello World’; para1.Range.InsertParagraphAfter; end; |
The equivalent in DirectOffice:
// create body Body := CoBody.Create; Document.AppendChild(Body as _OpenXmlElement); // create paragraph Paragraph := CoDocumentFormat_OpenXml_Wordprocessing_Paragraph.Create; Body.AppendChild(Paragraph as _OpenXmlElement); // create run for iNo := 1 to 10000 do begin Run := CoDocumentFormat_OpenXml_Wordprocessing_Run.Create; Paragraph.AppendChild(Run as _OpenXmlElement); // create text Text := CoDocumentFormat_OpenXml_Wordprocessing_Text.Create; Text.Text := ‘Hello, world!’; Run.AppendChild(Text as _OpenXmlElement); end; |
The estimated time to run the above code in Word for a lenghtly document, is ~ 3 minutes. If you were doing data-processing on a large document, it could possibly take upwards between 30 minutes to days.
The estimated time to run the above code in Direct Office is in seconds.
If your customer does not have Microsoft Word installed, or using a competing Word Processor, such as Google Docs or Libre Office, your applications built using DirectOffice can still function. Prior installation of Office or Word is not necessary.
Winsoft sells the full-version at the website, which can open Word, Excel and PowerPoint documents. Your customer’s time is important. Which solution will you choose?
- Works with: Delphi, C++Builder, VCL
- Works on: Windows 32-bit, Windows 64-bit, Web
Head over and check out the full WINSOFT Direct Office library for Delphi and C++Builder
Like what you see? You can get Direct Office and over 100 other fantastic WinSoft components with our Enterprise Component Pack. For a limited time, when you purchase RAD Studio Enterprise or Architect Edition at special Upgrade Pricing, you will also get this package of third-party software worth over $13,000, including the full WinSoft Component Library, at NO EXTRA COST! Step up to RAD Studio 10.4 today!