Структура PARAFORMAT (richedit.h)

Содержит сведения о атрибутах форматирования абзаца в элементе управления расширенными изменениями. Эта структура используется с EM_GETPARAFORMAT и EM_SETPARAFORMAT сообщениями.

В Microsoft Rich Edit 2.0 структура PARAFORMAT2 является расширением Microsoft Rich Edit 2.0 структуры PARAFORMAT. Microsoft Rich Edit 2.0 позволяет использовать любую структуру с EM_GETPARAFORMAT и EM_SETPARAFORMAT.

Синтаксис

typedef struct _paraformat {
  UINT  cbSize;
  DWORD dwMask;
  WORD  wNumbering;
  union {
    WORD wReserved;
    WORD wEffects;
  };
  LONG  dxStartIndent;
  LONG  dxRightIndent;
  LONG  dxOffset;
  WORD  wAlignment;
  SHORT cTabCount;
  LONG  rgxTabs[MAX_TAB_STOPS];
} PARAFORMAT;

Члены

cbSize

Тип: UINT

Размер структуры в байтах. Элемент должен быть заполнен перед передачей в элемент управления расширенными возможностями редактирования.

dwMask

Тип: DWORD

Элементы, содержащие допустимые сведения или атрибуты для задания. Этот параметр может быть ни один или сочетание следующих значений. Если указаны оба PFM_STARTINDENT и PFM_OFFSETINDENT, PFM_STARTINDENT имеет приоритет.

Ценность	Значение
PFM_ALIGNMENT	Допустимый элемент wAlignment.
PFM_NUMBERING	Допустимый элемент wNumbering.
PFM_OFFSET	Допустимый элемент dxOffset.
PFM_OFFSETINDENT	Элемент dxStartIndent является допустимым и указывает относительное значение.
PFM_RIGHTINDENT	Допустимый элемент dxRightIndent.
PFM_RTLPARA	rich Edit 2.0: допустимый элемент wEffects
PFM_STARTINDENT	Допустимый элемент dxStartIndent.
PFM_TABSTOPS	Допустимые элементы cTabStobs и rgxTabStops.

wNumbering

Тип: WORD

Значение, указывающее параметры нумерирования. Этот элемент может быть нулевым или PFN_BULLET.

wReserved

Тип: WORD

Rich Edit 1.0:: этот элемент называется wReserved. Скрытный; Значение должно быть равно нулю.

Rich Edit 2.0: Этот элемент называется wEffects. Битовый флаг, указывающий эффект абзаца. Он включен только для совместимости с интерфейсами TOM; Элемент управления расширенными изменениями сохраняет значение, но не использует его для отображения текста. Этот параметр может быть одним из следующих значений.

Ценность	Значение
0	Отображает текст с помощью порядка чтения слева направо. Это значение по умолчанию.
PFE_RLTPARA	Отображает текст с помощью порядка чтения справа налево.

wEffects

dxStartIndent

Тип: LONG

Отступ первой строки в абзаце в ветвях. Если задано форматирование абзаца и указано PFM_OFFSETINDENT, этот элемент рассматривается как относительное значение, добавляемое в начальную отступы каждого затронутого абзаца.

dxRightIndent

Тип: LONG

Размер отступа справа относительно правого поля в поворотах.

dxOffset

Тип: LONG

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

wAlignment

Тип: WORD

Значение, указывающее выравнивание абзаца. Этот элемент может быть одним из следующих значений.

Ценность	Значение
PFA_CENTER	Абзацы центрируются.
PFA_LEFT	Абзацы выровнены по левому краю.
PFA_RIGHT	Абзацы выровнены по правому краю.

cTabCount

Тип: SHORT

Количество остановок табуляции.

rgxTabs[MAX_TAB_STOPS]

Тип: LONG

Массив абсолютных позиций стоп-вкладок. Каждый элемент в массиве указывает сведения о остановке табуляции. 24 бита с низким порядком указывают абсолютное смещение в поворотах. Чтобы использовать этот элемент, задайте флаг PFM_TABSTOPS в элементе dwMask.

Rich Edit 2.0: Для совместимости с интерфейсами TOM можно использовать восемь битов высокого порядка для хранения дополнительных сведений о каждой остановке вкладки.

Биты 24-27 могут указать одно из следующих значений, чтобы указать выравнивание табуляции. Эти биты не влияют на отображение элемента управления расширенными изменениями для версий более ранних версий, чем Microsoft Rich Edit 3.0.

Ценность	Значение
0	Обычная вкладка
1	Вкладка "Центр"
2	Вкладка с выравниванием по правому краю
3	Вкладка "Десятичная"
4	Вкладка панели Word (вертикальная полоса)

 

Биты 28-31 могут указать одно из следующих значений, чтобы указать тип лидера табуляции. Эти биты не влияют на отображение элемента управления расширенными изменениями.

Ценность	Значение
0	Нет лидера
1	Пунктирный лидер
2	Дефисный лидер
3	Подчеркнутый лидер
4	Толстый лидер линии
5	Двойной лидер линии

Требования

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

См. также

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT2

Справочник