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

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

dxRightIndent

类型： LONG

大小，相对于右边距的右缩进，以缇为单位。

dxOffset

类型： LONG

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

wAlignment

类型： WORD

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

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

cTabCount

类型： SHORT

制表位数。

rgxTabs[MAX_TAB_STOPS]

类型： LONG

绝对制表位停止位置数组。 数组中的每个元素指定有关制表位的信息。 24 个低阶位指定绝对偏移量（以缇为单位）。 若要使用此成员，请在 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

引用