Поделиться через


структура 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
Никакой
1
Темная горизонтальная
2
Темная вертикали
3
Темный вниз диагонали
4
Темная диагонали
5
Темная сетка
6
Темный трелли
7
Световая горизонтальная
8
Свет вертикали
9
Свет вниз по диагонали
10
Свет вверх по диагонали
11
Светлая сетка
12
Легкий трелли
 

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

Ценность Значение
0
Чёрный
1
Синий
2
Голубой
3
Зеленый
4
Пурпурный
5
Красный
6
Жёлтый
7
Белый
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
Никакой
1
3/4 точки
2
11/2 точка
3
21/4 точка
4
3 пункта
5
41/2 точка
6
6 пунктов
7
3/4 точки двойной
8
11/2 точка двойной
9
21/4 точка двойная
10
3/4 точка серая
11
3/4 точка серая
 

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

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

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows Vista [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
заголовка richedit.h

См. также

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT