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

設定する有効な情報または属性を含むメンバー。 このパラメーターには、なし、または次の値の組み合わせを指定できます。 PFM_STARTINDENTとPFM_OFFSETINDENTの両方が指定されている場合は、PFM_STARTINDENTが優先されます。

値 説明
PFM_ALIGNMENT
 wAlignment メンバーは有効です。
PFM_NUMBERING
 wNumbering メンバーは有効です。
PFM_OFFSET
 dxOffset メンバーは有効です。
PFM_OFFSETINDENT
 dxStartIndent メンバーは有効であり、相対値を指定します。
PFM_RIGHTINDENT
 dxRightIndent メンバーは有効です。
PFM_RTLPARA
 リッチ エディット 2.0:wEffects メンバーが有効です
PFM_STARTINDENT
 dxStartIndent メンバーは有効です。
PFM_TABSTOPS
 cTabStobs メンバーと rgxTabStops メンバーは有効です。

wNumbering

種類: WORD

番号付けオプションを指定する値。 このメンバーには、0 またはPFN_BULLETを指定できます。

wReserved

種類: WORD

Rich Edit 1.0:: このメンバーの名前は wReserved です。 予約;値は 0 である必要があります。

リッチ エディット 2.0: このメンバーの名前は wEffects です。 段落効果を指定するビット フラグ。 TOM インターフェイスとの互換性のためにのみ含まれています。リッチ エディット コントロールは値を格納しますが、テキストの表示には使用しません。 このパラメーターには、次の値のいずれかを指定できます。

値 説明
0
 左から右への読み取り順序を使用してテキストを表示します。 既定値です。
PFE_RLTPARA
 右から左への読み取り順序を使用してテキストを表示します。

wEffects

dxStartIndent

型: LONG

段落の最初の行のインデント (twip 単位)。 段落の書式設定が設定されていて、PFM_OFFSETINDENTが指定されている場合、このメンバーは、影響を受ける各段落の開始インデントに追加される相対値として扱われます。

dxRightIndent

型: LONG

右余白に対する右インデントのサイズ (twip 単位)。

dxOffset

型: LONG

開始インデントに対する段落の 2 行目以降のインデント (twip 単位)。 このメンバーが負の場合は 1 行目がインデントされ、このメンバーが正の場合はインデントされます。

wAlignment

種類: WORD

段落の配置を指定する値。 このメンバーには、次のいずれかの値を指定できます。

値 説明
PFA_CENTER
 段落は中央揃えです。
PFA_LEFT
 段落は左余白に揃えられます。
PFA_RIGHT
 段落は右余白に揃えられます。

cTabCount

種類: SHORT

タブ位置の数。

rgxTabs[MAX_TAB_STOPS]

型: LONG

絶対タブ位置の配列。 配列内の各要素は、タブ位置に関する情報を指定します。 24 個の下位ビットは、絶対オフセットを twip 単位で指定します。 このメンバーを使用するには、 dwMask メンバーに PFM_TABSTOPS フラグを設定します。

リッチ エディット 2.0: TOM インターフェイスとの互換性のために、8 つの上位ビットを使用して、各タブ位置に関する追加情報を格納できます。

ビット 24 から 27 では、タブの配置を示す次のいずれかの値を指定できます。 これらのビットは、Microsoft Rich Edit 3.0 より前のバージョンのリッチ エディット コントロールの表示には影響しません。

値 説明
0
 通常のタブ
1
 [中央] タブ
2
 右揃えタブ
3
 [10 進数] タブ
4
 Word バー タブ (縦棒)
 

ビット 28 から 31 では、タブ リーダーの種類を示すために、次のいずれかの値を指定できます。 これらのビットは、リッチ エディット コントロールの表示には影響しません。

値 説明
0
 リーダーなし
1
 点線のリーダー
2
 破線のリーダー
3
 下線付きリーダー
4
 太い線の引き出し線
5
 二重線の引き出し線

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header richedit.h

関連項目

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT2

参照