PARAFORMAT2結構（Rich Edit 2.0）

包含豐富編輯控制件中段落格式屬性的相關信息。 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 可以指定下列其中一個值。（RTF 編輯控制件會儲存值，但不會使用它來顯示文字。

價值	意義
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

此成員也稱為 wReserved，因為已保留Microsoft Rich Edit 1.0。

Rich Edit 1.0： 保留;值必須是零。

Rich Edit 2.0： 指定段落效果的一組位旗標。這些旗標僅包含在與 TOM 介面的相容性中;RTF 編輯控制項會儲存值，但不會使用它來顯示文字。

這個成員可以是下列值的組合。

價值	意義
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

段落第一行的縮排，以 twip 為單位。後續行的縮排取決於 dxOffset 成員。若要使用 dxStartIndent 成員，請在 dwMask 成員中設定PFM_STARTINDENT或PFM_OFFSETINDENT旗標。如果您要設定縮排，請使用 PFM_STARTINDENT 旗標來指定左邊界的絕對縮排;或使用 PFM_OFFSETINDENT 旗標來指定相對於段落目前縮排的縮排。使用任一旗標來擷取目前的縮排。

dxRightIndent

類型：LONG

段落右側的縮排，相對於右邊界，以 twip 為單位。若要使用此成員，請在 dwMask 成員中設定PFM_RIGHTINDENT旗標。

dxOffset

類型：LONG

第二行和後續行的縮排，相對於第一行的縮排，以 twip 為單位。如果這個成員為正數，則會縮排第一行。若要使用此成員，請在 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 個低序位會以 twip 為單位指定絕對位移。若要使用此成員，請在 dwMask 成員中設定PFM_TABSTOPS旗標。

Rich Edit 2.0： 為了與 TOM 介面相容，您可以使用八個高階位來儲存每個製表位的其他資訊。

位 24-27 可以指定下列其中一個值，以指出索引標籤對齊方式。這些位不會影響早於 Microsoft Rich Edit 3.0 版本的豐富編輯控件顯示。

價值	意義
0	一般索引標籤
1	中心索引標籤
2	靠右對齊的索引標籤
3	十進位索引標籤
4	文字列索引標籤（垂直線）

位 28-31 可以指定下列其中一個值，以指出索引標籤領導者的類型。這些位不會影響豐富的編輯控件顯示。

價值	意義
0	沒有領導者
1	點狀領導者
2	虛線領導者
3	底線領導者
4	粗線領導
5	雙線領導者

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

意見反應

此頁面對您有幫助嗎？

Last updated on 2024-08-15

共用方式為

PARAFORMAT2結構 （Rich Edit 2.0）

語法

成員

要求

另請參閱

意見反應

其他資源

PARAFORMAT2結構（Rich Edit 2.0）