Объект Word Font - параметры форматирования шрифта

Приветствую всех читателей блога scriptcoding.ru. В этой публикации мы рассмотрим объект Font, который позволяет задать основные параметры шрифта в Word.

В прошлых статьях мы научились создавать приложение Word (смотрите "Word.Application"), новый документ (смотрите "Word.Documents") и также рассмотрели процесс добавления заданного текста в созданный документ с помощью объекта Selection (смотрите "Word.Selection"). Теперь настало время познакомиться с объектом Font, доступ к которому можно получить через одноименное свойство. Фактически, объект Font позволяет задать параметры форматирования шрифта.

Объект Font - основные параметры шрифта в Word

Сам по себе класс Font довольно прост, так как все свойства и методы интуитивно понятны. Сами свойства я разбил на несколько категорий в зависимости от их типа. И так, приступим…

Свойства класса Font – параметры форматирования шрифта

Свойства, которые доступны для чтения и для записи, принимают логические значения TRUE или FALSE. При установлении значения TRUE свойства позволяют отформатировать выделенный текст: сделать жирным, курсивом, подчеркнутым и так далее.

AllCaps – Все прописные.

SmallCaps – Малые прописные.

Bold – Жирный шрифт в Word, само свойство возвращает True, False или wdUndefined (смесь True или False)

DoubleStrikeThrough – Двойное зачеркивание.

StrikeThrough – Одинарное зачеркивание.

Emboss – Приподнятый.

Engrave – Утопленный.

Italic – Курсив.

Outline – Контур.

Shadow – С тенью.

Subscript – Подстрочный знак.

Superscript – Надстрочный знак.

Свойства, которые позволяют задать или получить значение, заданное определенной константой (если происходит выполнение кода в редакторе VBA то можно использовать не целое число, и именованное значение).

ColorIndex – Параметры цвета текста шрифта в Word, значения константы WdColorIndex:

• wdAuto - 0 - Автоматический цвет. По умолчанию, обычно черный цвет.
• wdByAuthor - -1 - Цвет определяется автором документа
• wdNoHighlight - 0 - Удаляет подсветку.
• wdBlack - 1 – черный.
• wdBlue - 2 – синий.
• wdTurquoise - 3 – бирюзовый.
• wdBrightGreen - 4 - ярко-зеленый.
• wdPink - 5 – розовый.
• wdRed - 6 – красный.
• wdYellow - 7 – желтый.
• wdWhite - 8 – белый.
• wdDarkBlue - 9 - темно-синий.
• wdTeal - 10 – бирюзовый.
• wdGreen - 11 – зеленый.
• wdViolet - 12 – фиолетовый.
• wdDarkRed - 13 - темно-красный.
• wdDarkYellow - 14 - темно-желтый.
• wdGray50 - 15 - тень 50 серого.
• wdGray25 - 16 - тень 25 серого.

Underline - Тип подчеркивания, заданный значением константы WdUnderline:

• wdUnderlineNone - 0 - нет подчеркивания.
• wdUnderlineSingle - 1 - одна линия, по умолчанию.
• wdUnderlineWords - 2 - подчеркнет только отдельные слова.
• wdUnderlineDouble - 3 - двойная линия.
• wdUnderlineDotted - 4 – точки.
• wdUnderlineThick - 6 - единая жирная линия.
• wdUnderlineDash - 7 – тире.
• wdUnderlineDotDash - 9 - чередующиеся точки и тире.
• wdUnderlineDotDotDash - 10 – чередующиеся две точки и тире.
• wdUnderlineWavy - 11 - одна волнистая линия.
• wdUnderlineDottedHeavy - 20 – жирные точки.
• wdUnderlineDashHeavy - 23 - жирные тире.
• wdUnderlineDotDashHeavy - 25 - чередующиеся жирные точки и жирные тире.
• wdUnderlineDotDotDashHeavy - 26 - чередующиеся жирные две точки и тире.
• wdUnderlineWavyHeavy - 27 - жирная волнистая линия.
• wdUnderlineDashLong - 39 - длинное тире.
• wdUnderlineWavyDouble - 43 - двойная волнистая линия.
• wdUnderlineDashLongHeavy - 55 - длинное жирное тире.

UnderlineColor - Возвращает или устанавливает 24-битный цвет подчеркивания, содержит значение константы WdColor:

• wdColorAqua - 13421619 - аква
• wdColorAutomatic - 16777216 - Автоматическая цвет. По умолчанию, обычно черный цвет.
• wdColorBlack - 0 – черный.
• wdColorBlue - 16711680 – синий.
• wdColorBlueGray - 10053222 - сине-серый.
• wdColorBrightGreen - 65280 - ярко-зеленый.
• wdColorBrown - 13209 – коричневый.
• wdColorDarkBlue - 8388608 - темно-синий.
• wdColorDarkGreen - 13056 - темно-зеленый.
• wdColorDarkRed - 128 - темно-красный.
• wdColorDarkTeal - 6697728 – темно-бирюзовый.
• wdColorDarkYellow - 32896 - темно-желтый.
• wdColorGold - 52479 – золотистый.
• wdColorGray05 - 15987699 - тень05серого.
• wdColorGray10 - 15132390 - тень10серого.
• wdColorGray125 - 14737632 - тень125серого.
• wdColorGray15 - 14277081 - тень15серого.
• wdColorGray20 - 13421772 - тень20серого.
• wdColorGray25 - 12632256 - тень25серого.
• wdColorGray30 - 11776947 - тень30серого.
• wdColorGray35 - 10921638 - тень35 серого.
• wdColorGray375 - 10526880 - тень375серого.
• wdColorGray40 - 10066329 - тень40серого.
• wdColorGray45 - 9211020 - тень45серого.
• wdColorGray50 - 8421504 - тень50серого.
• wdColorGray55 - 7566195 - тень55серого.
• wdColorGray60 - 6710886 - тень60серого.
• wdColorGray625 - 6316128 - тень625серого.
• wdColorGray65 - 5855577 - тень65серого.
• wdColorGray70 - 5000268 - тень70серого.
• wdColorGray75 - 4210752 - тень75серого.
• wdColorGray80 - 3355443 - тень80серого.
• wdColorGray85 - 2500134 - тень85серого.
• wdColorGray875 - 2105376 - тень875серого.
• wdColorGray90 - 1644825 - тень90серого.
• wdColorGray95 - 789516 - тень95серого.
• wdColorGreen - 32768 – зеленый.
• wdColorIndigo - 10040115 – синий.
• wdColorLavender - 16751052 – бледно-лиловый.
• wdColorLightBlue - 16737843 - светло-синий.
• wdColorLightGreen - 13434828 - светло-зеленый.
• wdColorLightOrange - 39423 - светло-оранжевый.
• wdColorLightTurquoise - 16777164 – светло-бирюзовый.
• wdColorLightYellow - 10092543 - светло-желтый.
• wdColorLime - 52377 – липовый.
• wdColorOliveGreen - 13107 – оливково-зеленый.
• wdColorOrange - 26367 – оранжевый.
• wdColorPaleBlue - 16764057 - бледно-голубой.
• wdColorPink - 16711935 – розовый.
• wdColorPlum - 6697881 - темно-фиолетовый.
• wdColorRed - 255 – красный.
• wdColorRose - 13408767 – розовый.
• wdColorSeaGreen - 6723891 – зеленый.
• wdColorSkyBlue - 16763904 - небесно-голубой.
• wdColorTan - 10079487 - желтовато-коричневый.
• wdColorTeal - 8421376 - бирюзовый.
• wdColorTurquoise - 16776960 - Бирюзовый цвет.
• wdColorViolet - 8388736 – фиолетовый.
• wdColorWhite - 16777215 – белый.
• wdColorYellow - 65535 – желтый.

DiacriticColor - Как ColorIndex, позволяет задать параметры цвета текста шрифта в word, принимает значения константы WdColor.

Прочие свойства, которые позволяют получить или задать такие основные параметры шрифта в Word, как размер, имя и так далее.

Position – Позволяет получить или задать смещение текста в пунктах относительно базовой линии.

Scaling - Возвращает или устанавливает процент масштаба, применяемого к шрифтом.

Spacing - Возвращает или задает расстояние в пунктах между символами. Считывание / запись

Size – Позволяет получить или установить параметры форматирования шрифта в Word: размер в пунктах.

Name - Возвращает или задает имя.

Методы объекта Font – параметры форматирования шрифта в Word

Grow() - Увеличивает размер на один пункт.

Shrink() - Уменьшает размер на один пункт.

Reset() – Полностью очищает параметры форматирования текст шрифта в Word.

Хорошо, основные свойства и методы мы рассмотрели, теперь настало время приступить к программированию, я напишу два примера под Wndows Script Host. Логика проста: происходит создание нового документа Word, далее происходит вставка текста с помощью объекта Selection, после происходит выделение различных диапазонов текста и их форматирование – основные параметры шрифта в Word.

Пример на VBScript

' ------------------------------------------------
' Объект Word Font
' Основные параметры шрифта в Word
' Font.vbs
' ------------------------------------------------
Option Explicit
 
dim oWord, oDoc, oSel, SelText, i, oFon, sel
 
' ссылка на объект Word Application
Set oWord = CreateObject("Word.Application")
' ссылка на колекцию Documents
Set oDoc = oWord.Documents
' создаем новый документ                                                                                                     основные параметры шрифта в Word
oDoc.Add()
' ссылка на объект Selection
Set oSel = oWord.Selection
' ссылка на объект Font
Set oFon = oSel.Font
' делаем документ видимым
oWord.Visible = true
 
With oSel
     For i = 0 To 100
                 ' вставляем текст
                 .Text = "параметры форматирования шрифта в Word"
                 ' Перемещаем курсор в конец текста
                 .EndOf
                 ' вставляем параграф
                 .TypeParagraph
     Next
End With
 
'-------------------------------------------------------------
' Форматируем текст в документе Word
'-------------------------------------------------------------

With oSel
     .SetRange 0,50
     oFon.Bold = true
     .SetRange 50,100
     oFon.DoubleStrikeThrough = true
     .SetRange 100,150
     oFon.Emboss = true
     .SetRange 150,200
     oFon.Engrave=true
     .SetRange 200,250
     oFon.Italic = true
     .SetRange 250,300
     oFon.Outline = true
     .SetRange 300,350
     oFon.Shadow = true
     .SetRange 350,400
     oFon.SmallCaps = true
     .SetRange 400,450
     oFon.Subscript = true
     .SetRange 450,500
     oFon.Superscript = true
     .SetRange 500,550
     oFon.StrikeThrough = true
     .SetRange 550,600
     oFon.Hidden = true
     .SetRange 600,650
     oFon.Name = "Times New Roman"                                                                                     ' основные параметры шрифта Word
     .SetRange 650,700
     oFon.Position = 50
     .SetRange 750,800
     oFon.Scaling = 120
     .SetRange 800,850
     oFon.Size = 30
     .SetRange 850,900
     oFon.Spacing = 20
     .SetRange 900,950
     oFon.Underline = 10
     oFon.UnderlineColor=8421376
End With
 
With oFon          
     sel = 950
     ' меняем цвет для разных фрагментов
     for i=1 to 16
                 sel = 950+(i*200)
                 oSel.SetRange sel+100, sel + 200
                 .ColorIndex = i
                 sel = sel + 200
     next
 
     ' делаем задержку в 3 секунды
     Wscript.Sleep 3000
     ' выделяем весь текст
     oDoc(1).Select
     Wscript.Sleep 3000
     ' очищаем параметры форматирования текста шрифта в Word
     .Reset
     ' устанавливаем верхний регистр
     .AllCaps = true
     Wscript.Sleep 3000
     ' устанавливаем нижний регистр
     .SmallCaps = true
End With

Пример на JScript

// ------------------------------------------------
// Объект Word Font
// Основные параметры шрифта в Word
// Font.js
// ------------------------------------------------
var oWord1, oDoc1, oSel1, SelText, i, oFon1, sel1;
 
// ссылка на объект Word Application
oWord1 = WScript.CreateObject("Word.Application");
// ссылка на коллекцию Documents
oDoc1 = oWord1.Documents;
// создаем новый документ                                                                                                    параметры форматирования шрифта
oDoc1.Add();
// ссылка на объект Selection
oSel1 = oWord1.Selection;
// ссылка на объект Font
oFon1 = oSel1.Font;
// делаем документ видимым
oWord1.Visible = true;
 
with (oSel1){
     for(i = 0; i<=100; i++){
                 // вставляем текст
                 Text = "параметры форматирования шрифта в Word";
                 // Перемещаем курсор в конец текста
                 EndOf();
                 // вставляем параграф
                 TypeParagraph();
     }
}
 
//--------------------------------------------------------
// Форматируем текст в документе Word
//--------------------------------------------------------
with (oSel1){
     SetRange(0,50);
     oFon1.Bold = true;
     SetRange(50,100);
     oFon1.DoubleStrikeThrough = true;
     SetRange(100,150);
     oFon1.Emboss = true;
     SetRange(150,200);
     oFon1.Engrave=true;
     SetRange(200,250);
     oFon1.Italic = true;                                                                                                  // параметры форматирования шрифта
     SetRange(250,300);
     oFon1.Outline = true;
     SetRange(300,350);
     oFon1.Shadow = true;
     SetRange(350,400);
     oFon1.SmallCaps = true;
     SetRange(400,450);
     oFon1.Subscript = true;
     SetRange(450,500);
     oFon1.Superscript = true;
     SetRange(500,550);
     oFon1.StrikeThrough = true;
     SetRange(550,600);
     oFon1.Hidden = true;
     SetRange(600,650);
     oFon1.Name = "Times New Roman";
     SetRange(650,700);
     oFon1.Position = 50;
     SetRange(750,800);
     oFon1.Scaling = 120;
     SetRange(800,850);
     oFon1.Size = 30;
     SetRange(850,900);
     oFon1.Spacing = 20;
     SetRange(900,950);
     oFon1.Underline = 10;
     oFon1.UnderlineColor=8421376;
}
with (oFon1){
     sel1 = 950;
     // меняем цвет для разных фрагментов
     for(i = 0; i<=16; i++){
                 sel1 = 950+(i*200);
                 oSel1.SetRange(sel1+100, sel1 + 200);
                 ColorIndex = i;
                 sel1 += 200;
     }
 
     // делаем задержку в 3 секунды
     WScript.Sleep(3000)
     // выделяем весь текст
     oDoc1(1).Select();
     WScript.Sleep(3000);
     // очищаем параметры форматирования текста шрифта в Word
     Reset();
     // устанавливаем верхний регистр
     AllCaps = true;
     WScript.Sleep(3000)
     // устанавливаем нижний регистр
     SmallCaps = true;
}

Хорошо, теперь давайте разберем данные примеры. Логика работы программного кода одинакова, сразу после создания документа происходит несколько этапов:

Этап первый – в цикле for (смотрите синтаксис для языка vbscript - "Урок 6 по VBScript: Циклы for…next и for each…next" и jscript - "Урок 9 по JScript - оператор цикла for") происходит вставка текста, с учетом параграфа и перевода строки.

Этап второй – Тут в блоке with содержится длинная череда из выделения фрагментов, для которых задаются основные параметры шрифта в Word: размер, отступы, имя и так далее.

Этап третий – Снова следует блок with, в теле которого выборочно происходит смена цвета для выделенных фрагментов. Далее с задержкой в 3 секунды (смотрите статью "Объект WScript - методы sleep, quit и echo и 8 свойств") сбрасываются параметры форматирования шрифта и меняется регистр символов.