структура PARAFORMAT2 (richedit.h)

  • Статья

Содержит сведения об атрибутах форматирования абзаца в расширенном элементе управления редактирования. PARAFORMAT2 — это расширение microsoft Rich Edit 2.0 структуры PARAFORMAT . Microsoft Rich Edit 2.0 позволяет использовать обе структуры с EM_GETPARAFORMAT и EM_SETPARAFORMAT сообщений.

Синтаксис

struct PARAFORMAT2 : _paraformat {
  LONG  dySpaceBefore;
  LONG  dySpaceAfter;
  LONG  dyLineSpacing;
  SHORT sStyle;
  BYTE  bLineSpacingRule;
  BYTE  bOutlineLevel;
  WORD  wShadingWeight;
  WORD  wShadingStyle;
  WORD  wNumberingStart;
  WORD  wNumberingStyle;
  WORD  wNumberingTab;
  WORD  wBorderSpace;
  WORD  wBorderWidth;
  WORD  wBorders;
};

Наследование

Структура PARAFORMAT2 реализует _paraformat.

Элементы

dySpaceBefore

Тип: LONG

Размер интервала над абзацем в твипах. Чтобы использовать этот элемент, установите флаг PFM_SPACEBEFORE в элементе dwMask . Значение должно быть больше либо равно нулю.

dySpaceAfter

Тип: LONG

Указывает размер интервала под абзацем в твипах. Чтобы использовать этот элемент, установите флаг PFM_SPACEAFTER в элементе dwMask . Значение должно быть больше либо равно нулю.

dyLineSpacing

Тип: LONG

Интервал между линиями. Описание интерпретации этого значения см. в разделе член bLineSpacingRule . Чтобы использовать этот элемент, установите флаг PFM_LINESPACING в элементе dwMask .

sStyle

Тип: SHORT

Стиль текста. Чтобы использовать этот элемент, установите флаг PFM_STYLE в элементе dwMask . Этот элемент включается только для обеспечения совместимости с интерфейсами TOM и Word. Элемент управления расширенными правками сохраняет значение, но не использует его для отображения текста.

bLineSpacingRule

Тип: BYTE

Тип междустрочного интервала. Чтобы использовать этот элемент, установите флаг PFM_LINESPACING в элементе dwMask . Этот элемент может быть одним из следующих значений.

Значение Значение
0
 Один интервал. Элемент dyLineSpacing игнорируется.
1
 Полутора интервалов. Элемент dyLineSpacing игнорируется.
2
 Двойной интервал. Элемент dyLineSpacing игнорируется.
3
 Член dyLineSpacing задает интервал от одной строки к другой в твипах. Однако если dyLineSpacing задает значение, которое меньше одного интервала, элемент управления отображает текст с одним пробелом.
4
 Член dyLineSpacing задает интервал от одной строки к другой в твипах. Элемент управления использует точный указанный интервал, даже если dyLineSpacing задает значение, которое меньше одного интервала.
5
 Значение dyLineSpacing / 20 — это интервал в строках от одной строки к другой. Таким образом, при установке dyLineSpacing значения 20 создается текст с одним пробелом, 40 — двойное, 60 — тройное и т. д.

bOutlineLevel

Тип: BYTE

Защищены; значение должно быть равно нулю.

wShadingWeight

Тип: WORD

Цвет переднего плана в процентах, используемый при заливке. Член wShadingStyle задает цвета переднего плана и фона заливки. Значение 5 указывает цвет заливки, состоящий из 5 процентов цвета переднего плана и 95 процентов цвета фона. Чтобы использовать эти элементы, установите флаг PFM_SHADING в элементе dwMask . Этот элемент включается только для совместимости с Word. Элемент управления расширенным редактированием сохраняет значение, но не использует его для отображения текста.

wShadingStyle

Тип: WORD

Стиль и цвета, используемые для заливки фона. Биты от 0 до 3 содержат стиль заливки, биты от 4 до 7 содержат индекс цвета переднего плана, а биты от 8 до 11 содержат индекс цвета фона. Чтобы использовать этот элемент, установите флаг PFM_SHADING в элементе dwMask . Этот элемент включается только для совместимости с Word. Элемент управления расширенным редактированием сохраняет значение, но не использует его для отображения текста.

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

Значение Значение
0
 None
1
 Темный горизонтальный
2
 Темная вертикальная
3
 Темный вниз по диагонали
4
 Темный вверх по диагонали
5
 Темная сетка
6
 Темная шпалера
7
 Светлая горизонтальная
8
 Свет по вертикали
9
 Свет вниз по диагонали
10
 Загореть по диагонали
11
 Светлая сетка
12
 Световые шпалеры
 

Цветовые индексы переднего плана и фона могут иметь одно из следующих значений.

Значение Значение
0
 Черный
1
 Синий
2
 Голубой
3
 Зеленый
4
 Пурпурный
5
 Красный
6
 Желтый
7
 White
8
 Синий
9
 Темно-голубой
10
 Темно-зеленый
11
 Темная пурпурная
12
 Темно-красный
13
 Темно-желтый
14
 Темно-серый
15
 Светло-серый

wNumberingStart

Тип: WORD

Начальное число или значение Юникода, используемое для нумерованных абзацев. Используйте этот элемент в сочетании с элементом wNumbering . Этот элемент включен только для обеспечения совместимости с интерфейсами TOM; Элемент управления полнофункциональное редактирование сохраняет значение, но не использует его для отображения текста или маркеров. Чтобы использовать этот элемент, установите флаг PFM_NUMBERINGSTART в элементе dwMask .

wNumberingStyle

Тип: WORD

Стиль нумерирования, используемый с нумерованными абзацами. Используйте этот элемент в сочетании с элементом wNumbering . Этот элемент включен только для обеспечения совместимости с интерфейсами TOM; Элемент управления расширенным редактированием хранит значение, но версии полнофункционированного редактирования, предшествующие 3.0, не используют его для отображения текста или маркеров. Чтобы использовать этот элемент, установите флаг PFM_NUMBERINGSTYLE в элементе dwMask . Этот элемент может иметь одно из следующих значений.

Значение Значение
PFNS_PAREN
 Следует за числом с правой скобкой.
PFNS_PARENS
 Заключает число в круглые скобки.
PFNS_PERIOD
 Следует за числом с точкой.
PFNS_PLAIN
 Отображает только число.
PFNS_NONUMBER
 Продолжает нумерованный список без применения следующего номера или маркера.
PFNS_NEWNUMBER
 Начинает новый номер с параметром wNumberingStart.

wNumberingTab

Тип: WORD

Минимальный пробел между номером абзаца и текстом абзаца в твипах. Используйте этот элемент в сочетании с элементом wNumbering . Элемент wNumberingTab включен для совместимости с интерфейсами TOM; До версии Microsoft Rich Edit 3.0 элемент управления форматированным редактированием хранит значение, но не использует его для отображения текста. Чтобы использовать этот элемент, установите флаг PFM_NUMBERINGTAB в элементе dwMask .

wBorderSpace

Тип: WORD

Пространство между границей и текстом абзаца в твипах. Элемент wBorderSpace включен для совместимости с Word; элемент управления полнофункциональные изменения хранит значения, но не использует их для отображения текста. Чтобы использовать этот элемент, установите флаг PFM_BORDER в элементе dwMask .

wBorderWidth

Тип: WORD

Ширина границы в твипах. Чтобы использовать этот элемент, установите флаг PFM_BORDER в элементе dwMask .

wBorders

Тип: WORD

Расположение, стиль и цвет границы. Биты от 0 до 7 указывают расположения границ, биты 8–11 — стиль границы, а биты от 12 до 15 — индекс цвета границы. Чтобы использовать этот элемент, установите флаг PFM_BORDER в элементе dwMask .

Укажите расположения границ, используя сочетание следующих значений в битах от 0 до 7.

Значение Значение
1
 Левая граница.
2
 Правая граница.
4
 Верхняя граница.
8
 Нижняя граница.
16
 Внутренние границы.
32
 Внешние границы.
64
 Автокраска. Если этот бит задан, индекс цвета в битах от 12 до 15 не используется.
 

Укажите стиль границы, используя одно из следующих значений для битов от 8 до 11.

Значение Значение
0
 None
1
 3/4 очка
2
 11/2 очко
3
 21/4 пункта
4
 3 очка
5
 41/2 пункта
6
 6 пунктов
7
 3/4 очка double
8
 11/2 очка double
9
 21/4 точки double
10
 3/4 точки серого
11
 3/4 точки серый пунктирный
 

Укажите цвет границы, используя одно из следующих значений для битов от 12 до 15. Это значение игнорируется, если задан бит автокраски (бит 6).

Значение Значение
0
 Черный
1
 Синий
2
 Голубой
3
 Зеленый
4
 Пурпурный
5
 Красный
6
 Желтый
7
 White
8
 Синий
9
 Темно-голубой
10
 Темно-зеленый
11
 Темная пурпурная
12
 Темно-красный
13
 Темно-желтый
14
 Темно-серый
15
 Светло-серый

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть richedit.h

См. также раздел

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT