7.9.2 Свойства и методы сервера Word

Теперь очень коротко рассмотрим объекты, метода и свойства сервера Word.

Его описание, как правило, можно найти во встроенной справке Word. Изложение

в справке ведется на основе языка Visual Basic, а для младших версий Word — на

подмножестве этого языка WordBasic. Конечно, рассмотреть в рамках данной кни-

ги даже основы описания Word как объекта невозможно. Поэтому ниже изложены

только некоторые начальные сведения, впрочем, достаточные для разработки мно-

гих приложений, обращающихся к Word.

Обращение к свойствам объекта WordApplication, инкапсулирующего объект

Application (этот объект является самим выполняющимся экземпляром Word),

производится так же, как к свойствам любого объекта C++Builder. Например,

в Application имеется свойство Options — опции, являющееся в свою очередь объ-

ектом со множеством свойств. Среди этих свойств есть CheckSpellingAsYouType и

CheckGrammarAsYouType — булевы свойства, указывающие, должен ли Word ав-

томатически проверять синтаксис и грамматику и отмечать в тексте ошибки. Та-

кая проверка замедляет работу Word. Если вы хотите отключить в сервере эти ав-

томатические проверки, введите в приложение операторы:

WordApplicationl->Options->CheckSpellingAsYouType = false;

WordApplicationl->Options->CheckGrammarAsYouType = false/-

Тем самым вы отключите автоматические проверки, тем более что в случае, если

Word невидим и работает ≪за кадром≫, эти проверки совершенно бессмысленны.

Среди множества свойств Application следует отметить свойство Active-

Document — активный документ. Это объект Document, некоторые свойства и ме-

тоды которого будут описаны ниже.

Практически всегда при работе с сервером Word вам приходится иметь дело со

свойством Documents. Это свойство представляет собой собрание всех документов,

открытых в Word в данный момент. Каждый документ представлен в этом собра-

нии как объект Document, имеющий в свою очередь собственные свойства и мето-

ды. Общее число открытых документов определяется свойством Count собрания

документов Documents. Это свойство только для чтения часто приходится прове-

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

если в вашем приложении предусмотрены действия ASave, APrint и APreview,

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

их, очевидно, надо делать недоступными, если ни одного документа в Word нет.

Это можно осуществить следующим кодом:

if(WordApplicationl->Documents->Count == 0)

{

ASave->Enabled = false;

APreview->Enabled = false;

APrint->Enabled = false;

}

Создание нового документа Document и включение его в Documents осуществ-

ляется методом Add объекта Documents. В этот метод можно передать несколько

500 Глава 7

необязательных аргументов. Их число зависит от используемой версии компонен-

та WordApplication. Первые два аргумента в обеих версиях одинаковы: Template

и NewTemplate. Аргумент Template указывает шаблон, который используется

при создании документа. Если этот аргумент не указан, то документ создается на

основе шаблона Обычный (Normal). Аргумент NewTemplate булева типа определяет,

открывается ли документ как шаблон (при значении true), или как обычный доку-

мент. По умолчанию NewTemplate = false, т.е. отрывается обычный документ.

В WordApplication со страницы Office?/ все ограничивается этими двумя аргумен-

тами. В WordApplication со страницы Office2k имеется еще два необязательных ар-

гумента: DocumentType — тип документа и Visible — видимость.

При вызове из C++Builder Любого метода сервера СОМ аргументы (кроме аргу-

ментов типа Text) передаются только как объекты типа OleVariant. Если какие-то

аргументы не являются обязательными-, то все равно они должны фигурировать

в вызове метода. Только вместо их значений может быть указана EmptyParam —

переменная типа OleVariant, используемая вместо необязательных параметров.

Эта переменная объявлена в модуле System.

Таким образом, для WordApplication со страницы Office97, если вы хотите соз-

дать новый документ на основе обычного шаблона, вы можете записать оператор:

WordApplicationl->Documents->Add(EmptyParam, EmptyParam);

Но если вы хотите создать документ на основе своего шаблона C:\MyTemplate\

My.dot, то код будет сложнее:

TVariant Template = "С:\\MyTemplate\\My.dot";

WordApplicationl->Documents->Add(STemplate, EmptyParam);

А если требуется создать документ как новый шаблон на основе обычного шаб-

лона, то код будет таким:

TVariant Template = true;

WordApplicationl->Documents->Add(EmptyParam,STemplate);

При передаче булевых аргументов можно использовать значение 0 вместо false и

целое ненулевое значение (например, 1) вместо true. Поэтому, в последнем варианте

кода задание значения NewTemplate можно выполнить следующим оператором:

TVariant Template = 1;

Таким образом, при передаче булевых аргументов и свойств можно использо-

вать две различные формы записи значения.

Приведенные выше операторы подразумевали использование WordApplication

со страницы Office97. Для WordApplication со страницы Office2k обращение

к методу Add должно содержать четыре аргумента. Например:

TVariant Visible = false;

WordApplicationl->Documents->Add(

EmptyParam,EmptyParam,EmptyParam, Visible);

Важным свойством сервера Word является свойство Selection, являющееся

ссылкой на объект Selection — выделенный фрагмент текста в активном докумен-

те или, если нет выделения, то просто текущая позиция курсора в активном доку-

менте. Этот объект имеет методы InsertBefore и InsertAfter, аргументом в кото-

рые передается текст, вставляемый в активный документ соответственно до или

после объекта Selection. Например, код:

WordApplicationl->Selection->InsertAfter(TVariant('\n'));

WordApplicationl->Selection->InsertAfter(

TVariant("Дорогой " + Editl->Text + " ! \ n " ) ) ;

вставляет после Selection пустую строку, а затем вставляет строку с текстом ≪До-

рогой ... !≫, где вместо многоточия фигурирует текст окна редактирования Editl.

Если выделения текста не было, то все это вставляется после текущей позиции

курсора. В результате курсор перемещается на первую позицию после вставленно-

го текста, а весь вставленный текст выделяется, т.е. включается в Selection.

Процессы, потоки, распределенные приложения 501

То, что введенный текст выделяется, можно использовать для его форматирова-

ния. Форматирование объекта Selection осуществляется рядом его свойств, из кото-

рых остановимся только на двух: Font — шрифт и ParagraphFormat — формат аб-

заца. Конечно, можно работать с ними через компонент Word Application. Но гораз-

до удобнее делать это с помощью специальных серверов СОМ — компонентов

WordFont и WordParagraphFormat. Это серверы соответственно шрифта и формата

абзаца. Таких серверов объектов, входящих как свойство в другие объекты, на стра-

нице библиотеки Servers много. Подключение их к соответствующему объекту удоб-

нее осуществлять с помощью метода ConnectTo. Как аргумент этого метода указы-

вается объект, с которым связывается компонент. Например, операторы

WordFontl->ConnectTo(WordApplicationl->Selection->Font);

WordParagraphForraatl->ConnectTo(

WordApplication1->Seleetion->ParagraphFormat);

подключают компоненты WordFontl и WordParagraphFormatl соответственно

к шрифту и формату абзаца выделенного текста. После этого свойства и методы со-

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

Объект Font имеет, в частности, следующие свойства: Name — имя шрифта,

Bold — жирный, Italic — курсив, Size — размер, StrikeThrough — перечеркнутый,

DoubleStrikeThrough — перечеркнутый двойной линией, Underline — подчеркну-

тый, Shadow — с тенью, Emboss - - приподнятый, Engrave - - утопленный,

Hidden — невидимый, Subscript — нижний индекс, Superscript — верхний индекс.

Свойство Underline может принимать следующие значения: wdUnderlineNone -

отсутствие подчеркивания, wdUnderlineSingle и wdUnderlineDouble — одинарное

и двойное подчеркивание сплошной линией, wdUnderlineDash, wdUnderlineDot-

Dash, wdUnderlineDotDotDash, wdUnderlineThick, wdUnderlineDotted, wdUnderlineWords,

wdUnderlineWavy — различные типы линии подчеркивания.

В C++Builder 5 все эти свойства можно задавать непосредственно. Например,

операторы

WordFontl->Underline = wdUnderlineSingle; // В C++Builder 5

WordFontl->Bold = 1; // В C++Builder 5

обеспечивают в выделенном тексте (если WordFontl связан с выделением) жир-

ный подчеркнутый шрифт. Последний оператор можно заменить на эквивалент-

ный ему:

WordFontl->Bold = true; // В C++Builder 5

В C4-+Builder 6 все эти свойства только для чтения и должны задаваться спе-

циальными функциями записи. Так что приведенные выше операторы в C++BU11-

der 6 должна выглядеть так:

WordFontl->set_Underline(wdUnderlineSingle); // В C-n-Builder 6

WordFontl->set~Bold(l); // В C-n-Builder 6

Из свойств объекта ParagraphFormat и компонента WordParagraphFormat

отметим только одно: Alignment — выравнивание. Оно может принимать значе-

ния wdAlignParagraphLeft - - влево, wdAlignParagraphCenter - - по центру,

wdAlignParagraphRight — вправо, wdAlignParagraphJustify — по ширине. Как и

в случае предыдущих свойств, задание их различается в C++Builder 6 и 5. Напри-

мер, операторы

// В C++Builder 5:

WordParagraphFormatl->Alignment = wdAlignParagraphCenter;

/ / В C++Builder 6:

WordParagraphFormatl->set_Alignment(wdAlignParagraphCenter) ;

выравнивают текст объекта (выделенного фрагмента, если WordParagraphFormatl

связан с ним) по центру.

Выше рассматривалась вставка текста с помощью методов InsertBefore и

InsertAfter. Имеется ______еще один метод вставки текста —