PARAFORMAT2结构（richedit.h）

项目
08/15/2024

包含有关富编辑控件中段落格式属性的信息。 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

段落上方间距的大小（以 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

通过

PARAFORMAT2结构（richedit.h）

语法

遗产

成员

要求

另请参阅

反馈

其他资源