共用方式為

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 介面的相容性;RTF 編輯控制項會儲存值，但不會使用它來顯示文字。 此參數可以是下列其中一個值。

價值 意義
0
 使用由左至右閱讀順序顯示文字。 這是預設值。
PFE_RLTPARA
 使用由右至左的閱讀順序顯示文字。

wEffects

dxStartIndent

類型：LONG

段落中第一行的縮排，以 twip 為單位。 如果正在設定段落格式設定並指定PFM_OFFSETINDENT，這個成員會被視為新增至每個受影響段落起始縮排的相對值。

dxRightIndent

類型：LONG

大小，相對於右邊界的右縮排，以 twip 為單位。

dxOffset

類型：LONG

相對於開始縮排的第二行和後續段落行縮排，以 twip 為單位。 如果這個成員為正數，則會縮排第一行。

wAlignment

類型：WORD

指定段落對齊方式的值。 這個成員可以是下列其中一個值。

價值 意義
PFA_CENTER
 段落置中。
PFA_LEFT
 段落會對齊左邊界。
PFA_RIGHT
 段落會對齊右邊界。

cTabCount

類型：SHORT

製表位數目。

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
 雙線領導者

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 richedit.h

另請參閱

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT2

參考