PARAFORMAT2结构（Rich Edit 2.0）

2024-08-15

包含有关富编辑控件中段落格式属性的信息。 PARAFORMAT2 是 PARAFORMAT 结构的 Microsoft Rich Edit 2.0 扩展。 Microsoft Rich Edit 2.0 允许将任一结构用于 EM_GETPARAFORMAT 和 EM_SETPARAFORMAT 消息。

语法

typedef struct _paraformat2 {
  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];
  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;

成员

cbSize

类型：UINT

结构大小（以字节为单位）。将此结构传递给富编辑控件之前，请将 cbSize 设置为 paraFORMAT 或 PARAFORMAT2 结构的大小。如果 cbSize 等于 PARAFORMAT 结构的大小，则控件仅使用 PARAFORMAT 成员。

dwMask

类型：DWORD

包含有效信息的 PARAFORMAT2 结构的成员。 dwMask 成员可以是两组位标志中的值的组合。一组指示有效结构成员;另一组指示 wEffects 成员中的有效属性。

设置以下值以指示有效的结构成员。

价值	意义
PFM_ALIGNMENT	wAlignment 成员有效。
PFM_ALL	以下值的组合：PFM_STARTINDENT、PFM_RIGHTINDENT、PFM_OFFSET、PFM_ALIGNMENT、PFM_TABSTOPS、PFM_NUMBERING、PFM_OFFSETINDENT和PFM_RTLPARA。
PFM_ALL2	以下值的组合：PFM_ALL、PFM_EFFECTS、PFM_SPACEBEFORE、PFM_SPACEAFTER、PFM_LINESPACING、PFM_STYLE、PFM_SHADING、PFM_BORDER、PFM_NUMBERINGTAB、PFM_NUMBERINGSTART和PFM_NUMBERINGSTYLE。
PFM_BORDER	wBorderSpace、wBorderWidth，wBorders 成员有效。
PFM_LINESPACING	dyLineSpacing 和 bLineSpacingRule 成员有效。
PFM_NUMBERING	wNumbering 成员有效。
PFM_NUMBERINGSTART	wNumberingStart 成员有效。
PFM_NUMBERINGSTYLE	wNumberingStyle 成员有效。
PFM_NUMBERINGTAB	wNumberingTab 成员有效。
PFM_OFFSET	dxOffset 成员有效。
PFM_OFFSETINDENT	dxStartIndent 成员有效。如果要设置缩进，dxStartIndent 指定相对于当前缩进的缩进量。
PFM_OUTLINELEVEL	bOutlineLevel 成员有效。
PFM_RIGHTINDENT	dxRightIndent 成员有效。
PFM_SHADING	wShadingWeight 和 wShadingStyle 成员有效。
PFM_SPACEAFTER	dySpaceAfter 成员有效。
PFM_SPACEBEFORE	dySpaceBefore 成员有效。
PFM_STARTINDENT	dxStartIndent 成员有效，并指定左边距中的缩进。如果同时指定了PFM_STARTINDENT和PFM_OFFSETINDENT，则PFM_STARTINDENT优先。
PFM_STYLE	sStyle 成员有效。
PFM_TABSTOPS	cTabCount 和 rgxTabs 成员有效。

设置以下值以指示 wEffects 成员的有效属性。

价值	意义
PFM_DONOTHYPHEN	PFE_DONOTHYPHEN值有效。
PFM_EFFECTS	以下值的组合：PFM_RTLPARA、PFM_KEEP、PFM_KEEPNEXT、PFM_TABLE、PFM_PAGEBREAKBEFORE、PFM_NOLINENUMBER、PFM_NOWIDOWCONTROL、PFM_DONOTHYPHEN、PFM_SIDEBYSIDE和PFM_TABLEROWDELIMITER。
PFM_KEEP	PFE_KEEP值有效。
PFM_KEEPNEXT	PFE_KEEPNEXT值有效。
PFM_NOLINENUMBER	PFE_NOLINENUMBER值有效。
PFM_NOWIDOWCONTROL	PFE_NOWIDOWCONTROL值有效。
PFM_PAGEBREAKBEFORE	PFE_PAGEBREAKBEFORE值有效。
PFM_RTLPARA	PFE_RTLPARA值有效。
PFM_SIDEBYSIDE	PFE_SIDEBYSIDE值有效。
PFM_TABLE	PFE_TABLE值有效。
PFM_TABLEROWDELIMITER	PFE_TABLEROWDELIMITER值有效。

wNumbering

类型：WORD

用于项目符号或编号段落的选项。若要使用此成员，请设置 dwMask 成员中的PFM_NUMBERING标志。

此成员可以是以下值之一。

价值	意义
零	没有段落编号或项目符号。
PFN_BULLET	在每个选定段落的开头插入项目符号。

低于版本 3.0 的丰富编辑版本不显示段落编号。但是，为了与Microsoft 文本对象模型（TOM）接口兼容，wNumbering 可以指定以下值之一。（富编辑控件存储值，但不使用它来显示文本。

价值	意义
PFN_ARABIC	使用阿拉伯语数字（0、1、2 等）。
PFN_LCLETTER	使用小写字母（a、b、c 等）。
PFN_LCROMAN	使用小写罗马字母（i、ii、iii 等）。
PFN_UCLETTER	使用大写字母（A、B、C 等）。
PFN_UCROMAN	使用大写罗马字母（I、II、III 等）。
7	使用以 wNumberingStart 成员指定的 Unicode 字符开头的字符序列。

wReserved

wEffects

类型：WORD

此成员也称为 Microsoft Rich Edit 1.0 的 wReserved，因为它已保留。

Rich Edit 1.0： 保留;该值必须为零。

Rich Edit 2.0： 一组指定段落效果的位标志。这些标志仅用于与 TOM 接口的兼容性;富编辑控件存储值，但不使用它来显示文本。

此成员可以是以下值的组合。

价值	意义
PFE_DONOTHYPHEN	禁用自动断字符。
PFE_KEEP	段落中没有分页符。
PFE_KEEPNEXT	此段落和下一段之间没有分页符。
PFE_NOLINENUMBER	禁用行号（未实现）。
PFE_NOWIDOWCONTROL	禁用所选段落的寡妇和孤立控件。
PFE_PAGEBREAKBEFORE	在所选段落之前插入分页符。
PFE_RTLPARA	使用从右到左的阅读顺序显示文本（在 Rich Edit 2.1 及更高版本中）。
PFE_SIDEBYSIDE	并排显示段落（未实现）。
PFE_TABLE	段落是表格行。
PFE_TABLEROWDELIMITER	段落是表中行的起始分隔符（U+FFF9 U+000D）或结束分隔符（U+FFFB U+000D）。

dxStartIndent

类型：LONG

段落的第一行缩进（以 twips 为单位）。后续行的缩进取决于 dxOffset 成员。若要使用 dxStartIndent 成员，请设置 dwMask 成员中的PFM_STARTINDENT或PFM_OFFSETINDENT标志。如果要设置缩进，请使用PFM_STARTINDENT标志从左边距指定绝对缩进;或使用PFM_OFFSETINDENT标志指定相对于段落的当前缩进的缩进。使用任一标志检索当前缩进。

dxRightIndent

类型：LONG

段落右侧相对于右边距的缩进（以 twips 为单位）。若要使用此成员，请设置 dwMask 成员中的PFM_RIGHTINDENT标志。

dxOffset

类型：LONG

第二行和后续行的缩进，相对于第一行的缩进，以 twips 为单位。如果此成员为正数，则缩进第一行。如果此成员为正数，则缩进此成员。若要使用此成员，请设置 dwMask 成员中的PFM_OFFSET标志。

wAlignment

类型：WORD

段落对齐方式。若要使用此成员，请设置 dwMask 成员中的PFM_ALIGNMENT标志。此成员可以是以下值之一。

价值	意义
PFA_LEFT	段落与左边距对齐。
PFA_RIGHT	段落与右边距对齐。
PFA_CENTER	段落居中。
PFA_JUSTIFY	RichEdit 2.0：段落是正当的。早于 RichEdit 3.0 的丰富编辑控件显示与左边距对齐的文本。
PFA_FULL_INTERWORD	段落通过单独展开空白来对齐。

cTabCount

类型：SHORT

rgxTabs 数组中定义的制表位数。

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	双线前导符

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结构 （Rich Edit 2.0）

语法

成员

要求

另请参阅

反馈

其他资源

PARAFORMAT2结构（Rich Edit 2.0）