PARAFORMAT2結構 （richedit.h）

  • 發行項

包含豐富編輯控制件中段落格式屬性的相關信息。 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

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

dySpaceAfter

類型：LONG

以 twip 指定段落下方間距的大小。 若要使用此成員，請在 dwMask 成員中設定PFM_SPACEAFTER旗標。 值必須大於或等於零。

dyLineSpacing

類型：LONG

行之間的間距。 如需如何解譯此值的描述，請參閱 bLineSpacingRule 成員。 若要使用此成員，請在 dwMask 成員中設定PFM_LINESPACING旗標。

sStyle

類型：SHORT

文字樣式。 若要使用此成員，請在 dwMask 成員中設定PFM_STYLE旗標。 只有與 TOM 介面和 Word 相容，才包含此成員;RTF 編輯控制項會儲存值，但不會使用它來顯示文字。

bLineSpacingRule

類型：BYTE

行距的類型。 若要使用此成員，請在 dwMask 成員中設定PFM_LINESPACING旗標。 這個成員可以是下列其中一個值。

價值 意義
0
 單一間距。 會忽略 dyLineSpacing 成員。
1
 一個半間距。 會忽略 dyLineSpacing 成員。
2
 雙間距。 會忽略 dyLineSpacing 成員。
3
 dyLineSpacing 成員會以 twips 指定從一行到下一行的間距。 不過，如果 dyLineSpacing 指定小於單一間距的值，控件會顯示單一空格文字。
4
 dyLineSpacing 成員會以 twip 指定從一行到下一行的間距。 控件會使用指定的確切間距，即使 dyLineSpacing 指定小於單一間距的值也一樣。
5
 dyLineSpacing / 20 的值是從一行到下一行的間距。 因此，將 dyLineSpacing 設定為 20 會產生單一空格文字、40 為雙空格、60 為三個空格等等。

bOutlineLevel

類型：BYTE

保留;必須是零。

wShadingWeight

類型：WORD

底紋中使用的前景色彩百分比。 wShadingStyle 成員會指定前景和背景底紋色彩。 值為 5 表示陰影色彩，包含 5% 的前景色彩和 95% 的背景色彩。 若要使用這些成員，請在 dwMask 成員中設定PFM_SHADING旗標。 只有與 Word 相容，才包含此成員;RTF 編輯控制項會儲存值，但不會使用它來顯示文字。

wShadingStyle

類型：WORD

用於背景底紋的樣式和色彩。 位 0 到 3 包含底紋樣式、位 4 到 7 包含前景色彩索引，而位 8 到 11 則包含背景色彩索引。 若要使用此成員，請在 dwMask 成員中設定PFM_SHADING旗標。 只有與 Word 相容，才包含此成員;RTF 編輯控制項會儲存值，但不會使用它來顯示文字。

底紋樣式可以是下列其中一個值。

價值 意義
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 介面相容，才包含此成員;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 之前，RTF 編輯控件會儲存值，但不會使用它來顯示文字。 若要使用此成員，請在 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
 11/2 分雙
9
 21/4 分雙
10
 3/4 點灰色
11
 3/4 點灰色虛線
 

針對位 12 到 15，使用下列其中一個值指定框線色彩。 如果設定 autocolor 位 （bit 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