PARAFORMAT2结构(richedit.h)

包含有关富编辑控件中段落格式属性的信息。 PARAFORMAT2 是 PARAFORMAT 结构的 Microsoft Rich Edit 2.0 扩展。 Microsoft Rich Edit 2.0 允许将任一结构用于 EM_GETPARAFORMATEM_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

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

dySpaceAfter

类型:LONG

指定段落下方间距的大小(以 twips 为单位)。 若要使用此成员,请设置 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 成员以 twips 为单位指定从一行到下一行的间距。 但是,如果 dyLineSpacing 指定小于单个间距的值,控件将显示单间距文本。
4
dyLineSpacing 成员以 twips 为单位指定从一行到下一行之间的间距。 即使 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
6
黄色
7
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

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

wBorderSpace

类型:WORD

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

wBorderWidth

类型:WORD

边框宽度(以 twips 为单位)。 若要使用此成员,请设置 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
6
黄色
7
8
深蓝色
9
深青色
10
深绿色
11
深红
12
13
14
深灰色
15
浅灰色

要求

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

另请参阅

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT