richedit.h) PARAFORMAT2 結構 (

發行項
03/01/2024

包含豐富編輯控制件中段落格式屬性的相關信息。 PARAFORMAT2 是 PARAFORMAT 結構的 Microsoft Rich Edit 2.0 延伸模組。 Microsoft Rich Edit 2.0 可讓您搭配 EM_GETPARAFORMAT 和 EM_SETPARAFORMAT 訊息使用任一結構。

Syntax

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

段落上方間距的大小，以 twip 為單位。若要使用此成員，請在 dwMask 成員中設定PFM_SPACEBEFORE旗標。這個值必須大於或等於零。

dySpaceAfter

類型： LONG

以 twip 指定段落下方間距的大小。若要使用此成員，請在 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 成員會以 twip 指定從一行到下一行的間距。不過，如果 dyLineSpacing 指定小於單一間距的值，控件會顯示單一空格文字。
4	dyLineSpacing 成員會以 twip 指定從一行到下一行的間距。控件會使用指定的確切間距，即使 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	深色 trellis
7	淺色水準
8	淺色垂直
9	淺色向下對角線
10	亮起對角線
11	淺色網格線
12	淺色底形

前景和背景色彩索引可以是下列其中一個值。

值	意義
0	黑色
1	藍色
2	11：青色
3	綠色
4	桃紅色
5	紅色
6	黃色
7	白色
8	深藍色
9	深青色
10	深綠色
11	深紅色
12	深紅色
13	深黃色
14	深灰色
15	淺灰

wNumberingStart

類型： WORD

用於編號段落的起始數位或 Unicode 值。將此成員與 wNumbering 成員搭配使用。此成員僅包含與 TOM 介面的相容性;RTF 編輯控制項會儲存值，但不會使用它來顯示文字或項目符號。若要使用此成員，請在 dwMask 成員中設定PFM_NUMBERINGSTART旗標。

wNumberingStyle

類型： WORD

用於編號段落的編號樣式。將此成員與 wNumbering 成員搭配使用。此成員僅包含與 TOM 介面的相容性;RTF 編輯控件會儲存值，但早於 3.0 的豐富編輯版本不會使用它來顯示文字或項目符號。若要使用此成員，請在 dwMask 成員中設定PFM_NUMBERINGSTYLE旗標。這個成員可以是下列其中一個值。

值	意義
PFNS_PAREN	在數位後面加上右括弧。
PFNS_PARENS	以括弧括住數位。
PFNS_PERIOD	遵循具有句號的數位。
PFNS_PLAIN	只顯示數位。
PFNS_NONUMBER	繼續編號清單，而不套用下一個數位或項目符號。
PFNS_NEWNUMBER	使用 wNumberingStart 啟動新的數位。

wNumberingTab

類型： WORD

段落編號與段落文字之間的最小間距，以 twip 為單位。將此成員與 wNumbering 成員搭配使用。 包含 wNumberingTab 成員以便與 TOM 介面相容;在 Microsoft Rich Edit 3.0 之前，豐富編輯控件會儲存值，但不會使用它來顯示文字。若要使用此成員，請在 dwMask 成員中設定PFM_NUMBERINGTAB旗標。

wBorderSpace

類型： WORD

框線與段落文字之間的間距，以 twip 為單位。 wBorderSpace 成員隨附於與 Word 相容;豐富的編輯控件會儲存值，但不會使用這些成員來顯示文字。若要使用此成員，請在 dwMask 成員中設定PFM_BORDER旗標。

wBorderWidth

類型： WORD

框線寬度，以 Twip 為單位。若要使用此成員，請在 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	1 1/2 點雙精度浮點數
9	21/4 點雙精度浮點數
10	3/4 點灰色
11	3/4 點灰色虛線

針對位 12 到 15，使用下列其中一個值來指定框線色彩。如果設定自動著色位 (位 6) ，則會忽略此值。

值	意義
0	黑色
1	藍色
2	11：青色
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

共用方式為

richedit.h) PARAFORMAT2 結構 (

Syntax

繼承

成員

規格需求

另請參閱

意見反應

意見反應

其他資源