структура 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