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_GETPARAFORMATEM_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
リッチ エディット 2.0:wEffects メンバーは有効です
PFM_STARTINDENT
dxStartIndent メンバー が有効です。
PFM_TABSTOPS
cTabStobs および rgxTabStops メンバー 有効です。

wNumbering

型: WORD

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

wReserved

型: WORD

リッチ エディット 1.0:: このメンバーの名前は 予約済みです。 引っ込み思案;値は 0 である必要があります。

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

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

wEffects

dxStartIndent

型: long

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

dxRightIndent

型: long

右余白を基準とした右インデントのサイズ (twip 単位)。

dxOffset

型: long

開始インデントを基準とした段落の 2 行目以降のインデント (twip 単位)。 このメンバーが負の場合は最初の行がインデントされ、このメンバーが正の場合はインデントされます。

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 [デスクトップ アプリのみ]
ヘッダー richedit.h

関連項目

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT2

リファレンス