PARAFORMAT2 结构 (richedit.h)

  • 项目

包含有关丰富编辑控件中的段落格式设置属性的信息。 PARAFORMAT2 是 PARAFORMAT 结构的 Microsoft Rich Edit 2.0 扩展。 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

段落上方间距的大小（以缇为单位）。 若要使用此成员，请在 dwMask 成员中设置 PFM_SPACEBEFORE 标志。 该值必须大于或等于零。

dySpaceAfter

类型： LONG

指定段落下方间距的大小（以缇为单位）。 若要使用此成员，请在 dwMask 成员中设置 PFM_SPACEAFTER 标志。 该值必须大于或等于零。

dyLineSpacing

类型： LONG

行之间的间距。 有关如何解释此值的说明，请参阅 bLineSpacingRule 成员。 若要使用此成员，请在 dwMask 成员中设置 PFM_LINESPACING 标志。

sStyle

类型： SHORT

文本样式。 若要使用此成员，请在 dwMask 成员中设置 PFM_STYLE 标志。 包含此成员只是为了与 TOM 接口和Word兼容;丰富编辑控件存储值，但不使用它来显示文本。

bLineSpacingRule

类型： BYTE

行距的类型。 若要使用此成员，请在 dwMask 成员中设置 PFM_LINESPACING 标志。 此成员可以是以下值之一。

值 含义
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% 的背景色组成。 若要使用这些成员，请在 dwMask 成员中设置PFM_SHADING标志。 包含此成员只是为了与 Word 兼容;富编辑控件存储值，但不使用它来显示文本。

wShadingStyle

类型： WORD

用于背景着色的样式和颜色。 位 0 到 3 包含着色样式，位 4 到 7 包含前景色索引，位 8 到 11 包含背景色索引。 若要使用此成员，请在 dwMask 成员中设置 PFM_SHADING 标志。 包含此成员只是为了与 Word 兼容;富编辑控件存储值，但不使用它来显示文本。

底纹样式可以是以下值之一。

值 含义
0
 无
1
 深色水平
2
 深色垂直
3
 深色向下对角线
4
 深色向上对角线
5
 深色网格
6
 深色格子
7
 浅色水平
8
 浅色垂直
9
 浅色向下对角线
10
 亮起对角线
11
 浅色网格
12
 浅色格栅
 

前景色索引和背景色索引可以是以下值之一。

值 含义
0
 黑色
1
 蓝色
2
 青色
3
 绿色
4
 洋红色
5
 Red
6
 黄色
7
 White
8
 深蓝色
9
 深青色
10
 暗绿色
11
 深色洋红色
12
 深红色
13
 深黄色
14
 深灰色
15
 浅灰色

wNumberingStart

类型： WORD

用于编号段落的起始数字或 Unicode 值。 将此成员与 wNumbering 成员结合使用。 包含此成员仅用于与 TOM 接口兼容;富编辑控件存储值，但不使用它来显示文本或项目符号。 若要使用此成员，请在 dwMask 成员中设置PFM_NUMBERINGSTART标志。

wNumberingStyle

类型： WORD

与编号段落一起使用的编号样式。 将此成员与 wNumbering 成员结合使用。 包含此成员仅用于与 TOM 接口兼容;富编辑控件存储值，但低于 3.0 的丰富编辑版本不使用它来显示文本或项目符号。 若要使用此成员，请在 dwMask 成员中设置PFM_NUMBERINGSTYLE标志。 此成员可以是以下值之一。

值 含义
PFNS_PAREN
 紧跟带右括号的数字。
PFNS_PARENS
 将数字括在括号中。
PFNS_PERIOD
 后跟带句点的数字。
PFNS_PLAIN
 仅显示数字。
PFNS_NONUMBER
 继续编号列表，而不应用下一个数字或项目符号。
PFNS_NEWNUMBER
 使用 wNumberingStart 启动新数字。

wNumberingTab

类型： WORD

段落编号与段落文本之间的最小间距（以缇为单位）。 将此成员与 wNumbering 成员结合使用。 为了与 TOM 接口兼容，包含 wNumberingTab 成员;在 Microsoft Rich Edit 3.0 之前，格式编辑控件存储值，但不使用它来显示文本。 若要使用此成员，请在 dwMask 成员中设置 PFM_NUMBERINGTAB 标志。

wBorderSpace

类型： WORD

边框与段落文本之间的间距（以缇为单位）。 为了与 Word 兼容，包含 wBorderSpace 成员;丰富编辑控件存储值，但不使用这些值来显示文本。 若要使用此成员，请在 dwMask 成员中设置 PFM_BORDER 标志。

wBorderWidth

类型： WORD

边框宽度，以缇为单位。 若要使用此成员，请在 dwMask 成员中设置 PFM_BORDER 标志。

wBorders

类型： WORD

边框位置、样式和颜色。 位 0 到 7 指定边框位置，位 8 到 11 指定边框样式，位 12 到 15 指定边框颜色索引。 若要使用此成员，请在 dwMask 成员中设置 PFM_BORDER 标志。

使用以下值的组合（位 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
 Red
6
 黄色
7
 White
8
 深蓝色
9
 深青色
10
 暗绿色
11
 深洋红色
12
 深红色
13
 深黄色
14
 深灰色
15
 浅灰色

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 richedit.h

另请参阅

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT