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

段落中第一行的縮排，以 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
 Word列索引標籤 (垂直線)
 

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

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

需求

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

另請參閱

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT2

參考