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

Элементы, содержащие допустимые сведения или атрибуты для задания. Этот параметр может иметь значение none или сочетание следующих значений. Если указаны 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

Справочные материалы