PARAFORMAT2 構造体 (richedit.h)

  • [アーティクル]

リッチ エディット コントロールの段落書式属性に関する情報が含まれています。 PARAFORMAT2 は、 PARAFORMAT 構造体の Microsoft Rich Edit 2.0 拡張機能です。 Microsoft Rich Edit 2.0 では、 メッセージのEM_GETPARAFORMAT と EM_SETPARAFORMAT のいずれかの構造を使用できます。

構文

struct PARAFORMAT2 : _paraformat {
  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構造体は、_paraformatを実装します。

メンバー

dySpaceBefore

型: LONG

段落の上の間隔のサイズ (twip 単位)。 このメンバーを使用するには、 dwMask メンバーで PFM_SPACEBEFORE フラグを設定します。 値は 0 以上である必要があります。

dySpaceAfter

型: LONG

段落の下の間隔のサイズを twip 単位で指定します。 このメンバーを使用するには、 dwMask メンバーで PFM_SPACEAFTER フラグを設定します。 値は 0 以上である必要があります。

dyLineSpacing

型: LONG

行間の間隔。 この値の解釈方法の説明については、 bLineSpacingRule メンバーを 参照してください。 このメンバーを使用するには、 dwMask メンバーに PFM_LINESPACING フラグを設定します。

sStyle

種類: SHORT

テキスト スタイル。 このメンバーを使用するには、 dwMask メンバーで PFM_STYLE フラグを設定します。 このメンバーは TOM インターフェイスとWordとの互換性のためにのみ含まれています。リッチ エディット コントロールには値が格納されますが、テキストの表示には使用されません。

bLineSpacingRule

型: BYTE

行間の種類。 このメンバーを使用するには、 dwMask メンバーに PFM_LINESPACING フラグを設定します。 このメンバーには、次のいずれかの値を指定できます。

値 意味
0
 1 つの間隔。 dyLineSpacing メンバーは無視されます。
1
 1.5 の間隔。 dyLineSpacing メンバーは無視されます。
2
 2 行間隔。 dyLineSpacing メンバーは無視されます。
3
 dyLineSpacing メンバーは、1 行から次の行までの間隔を twip 単位で指定します。 ただし、 dyLineSpacing で 1 行未満の値が指定されている場合、コントロールには単一間隔のテキストが表示されます。
4
 dyLineSpacing メンバーは、1 行から次の行までの間隔を twip 単位で指定します。 dyLineSpacing で 1 行未満の値が指定されている場合でも、コントロールは指定された正確な間隔を使用します。
5
 dyLineSpacing/ 20 の値は、1 行から次の行までの間隔 (行単位) です。 したがって、 dyLineSpacing を 20 に設定すると、単一間隔のテキストが生成され、40 が 2 倍間隔、60 が 3 行間隔になります。

bOutlineLevel

型: BYTE

予約;は 0 である必要があります。

wShadingWeight

種類: WORD

網かけで使用される前景色の割合。 wShadingStyle メンバーは、前景色と背景の網かけの色を指定します。 値 5 は、前景色 5% と背景色 95% で構成される網かけの色を示します。 これらのメンバーを使用するには、 dwMask メンバーで PFM_SHADING フラグを設定します。 このメンバーは、Wordとの互換性のためにのみ含まれます。リッチ エディット コントロールは値を格納しますが、テキストの表示には使用しません。

wShadingStyle

種類: WORD

背景の網かけに使用されるスタイルと色。 ビット 0 から 3 には網かけのスタイルが含まれており、ビット 4 から 7 には前景色のインデックスが含まれており、ビット 8 から 11 には背景色のインデックスが含まれます。 このメンバーを使用するには、 dwMask メンバーで PFM_SHADING フラグを設定します。 このメンバーは、Wordとの互換性のためにのみ含まれます。リッチ エディット コントロールは値を格納しますが、テキストの表示には使用しません。

網かけのスタイルには、次のいずれかの値を指定できます。

値 意味
0
 なし
1
 濃い水平方向
2
 濃い縦
3
 対角線を暗く下げる
4
 対角線を暗くする
5
 濃いグリッド
6
 ダーク トレリス
7
 明るい水平
8
 明るい垂直
9
 ライトダウン対角線
"10"
 斜めに点灯
11
 ライト グリッド
12
 ライト トレリス
 

前景色と背景色のインデックスには、次のいずれかの値を指定できます。

値 意味
0
 Black
1
 青
2
 シアン
3
 [緑]
4
 赤紫
5
 [赤]
6
 黄
7
 White
8
 ダークブルー
9
 濃いシアン
"10"
 緑
11
 濃いマゼンタ
12
 濃い赤
13
 濃い黄色
14
 灰色
15
 ライト グレー

wNumberingStart

種類: WORD

段落番号に使用される開始番号または Unicode 値。 このメンバーを wNumbering メンバーと組み合わせて使用します。 このメンバーは、TOM インターフェイスとの互換性のためにのみ含まれています。リッチ エディット コントロールは値を格納しますが、テキストや箇条書きの表示には使用しません。 このメンバーを使用するには、 dwMask メンバーに PFM_NUMBERINGSTART フラグを設定します。

wNumberingStyle

種類: WORD

段落番号付きで使用される段落番号のスタイル。 このメンバーを wNumbering メンバーと組み合わせて使用します。 このメンバーは、TOM インターフェイスとの互換性のためにのみ含まれています。リッチエディットコントロールは値を格納しますが、3.0 より前のリッチエディットバージョンではテキストや箇条書きを表示するために使用されません。 このメンバーを使用するには、 dwMask メンバーで PFM_NUMBERINGSTYLE フラグを設定します。 このメンバーには、次のいずれかの値を指定できます。

値 意味
PFNS_PAREN
 右かっこで数値の後に続きます。
PFNS_PARENS
 数値をかっこで囲みます。
PFNS_PERIOD
 数値にピリオドを付けます。
PFNS_PLAIN
 数値のみを表示します。
PFNS_NONUMBER
 次の番号または箇条書きを適用せずに、番号付きリストを続行します。
PFNS_NEWNUMBER
 wNumberingStart を使用して新しい数値を開始します。

wNumberingTab

種類: WORD

段落番号と段落テキストの間の最小スペース (twip 単位)。 このメンバーを wNumbering メンバーと組み合わせて使用します。 TOM インターフェイスとの互換性のために wNumberingTab メンバーが含まれています。Microsoft Rich Edit 3.0 より前では、リッチエディット コントロールは値を格納しますが、テキストの表示には使用しません。 このメンバーを使用するには、 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 に対して次のいずれかの値を使用して、罫線の色を指定します。 オートカラー ビット (ビット 6) が設定されている場合、この値は無視されます。

値 意味
0
 Black
1
 青
2
 シアン
3
 [緑]
4
 赤紫
5
 [赤]
6
 黄
7
 White
8
 ダークブルー
9
 濃いシアン
"10"
 緑
11
 濃いマゼンタ
12
 濃い赤
13
 濃い黄色
14
 灰色
15
 ライト グレー

要件

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

こちらもご覧ください

EM_GETPARAFORMAT

EM_SETPARAFORMAT

PARAFORMAT