通过

PARAFORMAT 结构 （richedit.h）

  • 项目

包含有关富编辑控件中段落格式属性的信息。 此结构用于 EM_GETPARAFORMAT 和 EM_SETPARAFORMAT 消息。

在 Microsoft Rich Edit 2.0 中，PARAFORMAT2 结构是 PARAFORMAT 结构的 Microsoft Rich Edit 2.0 扩展。 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

段落中第一行的缩进，以 twips 为单位。 如果正在设置段落格式并指定PFM_OFFSETINDENT，则此成员被视为添加到每个受影响段落的起始缩进的相对值。

dxRightIndent

类型：LONG

相对于右边距的右缩进的大小（以 twips 为单位）。

dxOffset

类型：LONG

段落的第二行和后续行相对于起始缩进的缩进（以 twips 为单位）。 如果此成员为正数，则缩进第一行。如果此成员为正数，则缩进此成员。

wAlignment

类型：WORD

指定段落对齐方式的值。 此成员可以是以下值之一。

价值 意义
PFA_CENTER
 段落居中。
PFA_LEFT
 段落与左边距对齐。
PFA_RIGHT
 段落与右边距对齐。

cTabCount

类型：SHORT

制表位数。

rgxTabs[MAX_TAB_STOPS]

类型：LONG

绝对制表位位置的数组。 数组中的每个元素指定有关制表位的信息。 24 位低序位以 twips 为单位指定绝对偏移量。 若要使用此成员，请设置 dwMask 成员中的PFM_TABSTOPS标志。

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

参考