CHARFORMAT2A構造体 (richedit.h)

[アーティクル]
08/15/2024

リッチエディットコントロールの文字書式に関する情報が含まれています。 CHARFORMAT2 は、CHARFORMAT 構造体の Microsoft Rich Edit 2.0 拡張機能です。 Microsoft Rich Edit 2.0 では、EM_GETCHARFORMAT メッセージと EM_SETCHARFORMAT メッセージでどちらの構造を使用することもできます。

構文

struct CHARFORMAT2A : _charformat {
  WORD     wWeight;
  SHORT    sSpacing;
  COLORREF crBackColor;
  LCID     lcid;
  union {
    DWORD dwReserved;
    DWORD dwCookie;
  };
  DWORD    dwReserved;
  SHORT    sStyle;
  WORD     wKerning;
  BYTE     bUnderlineType;
  BYTE     bAnimation;
  BYTE     bRevAuthor;
  BYTE     bUnderlineColor;
};

継承

CHARFORMAT2A 構造体は、_charformatを実装します。

メンバーズ

wWeight

型: WORD

フォントの太さ。このメンバーは、LOGFONT 構造体の lfWeight メンバーと同じです。このメンバーを使用するには、dwMask メンバーで CFM_WEIGHT フラグを設定します。

sSpacing

型: SHORT

文字間の水平方向のスペース (twip 単位)。この値は、リッチエディットコントロールによって表示されるテキストには影響しません。これは、Windows TOM インターフェイスとの互換性のために含まれています。このメンバーを使用するには、dwMask メンバーで CFM_SPACING フラグを設定します。

crBackColor

型: COLORREF

背景色。このメンバーを使用するには、dwMask メンバーで CFM_BACKCOLOR フラグを設定します。 CFE_AUTOBACKCOLOR 文字効果が指定されている場合、このメンバーは無視されます。を生成するには、マクロを使用します。

lcid

型: LCID

下位の単語の言語識別子と、上位の単語の並べ替え識別子と予約値を含む 32 ビットロケール識別子。このメンバーは、リッチエディットコントロールによって表示されるテキストには影響しませんが、スペルチェックと文章校正では、言語に依存する問題に対処するために使用できます。このマクロを使用して、LCID 値を作成できます。このメンバーを使用するには、dwMask メンバーで CFM_LCID フラグを設定します。

dwReserved

型: DWORD

引っ込み思案;値は 0 である必要があります。

dwCookie

型: DWORD

クライアント Cookie。このメンバーは、リッチエディットコントロールに対して不透明です。

sStyle

型: SHORT

文字スタイルハンドル。この値は、リッチエディットコントロールによって表示されるテキストには影響しません。WindowsTOM インターフェイスとの互換性のために含まれています。このメンバーを使用するには、dwMask メンバーで CFM_STYLE フラグを設定します。詳細については、TOM のドキュメントを参照してください。

wKerning

型: WORD

文字をカーニングするフォントサイズの値 (yHeight)。この値は、リッチエディットコントロールによって表示されるテキストには影響しません。TOM インターフェイスとの互換性のために含まれています。このメンバーを使用するには、dwMask メンバーで CFM_KERNING フラグを設定します。

bUnderlineType

型: BYTE

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

価値	意味
CFU_CF1UNDERLINE	構造体 CHARFORMATのビット下線を CHARFORMAT2にマップします (つまり、このテキストの下線の CHARFORMAT 型を実行します)。
CFU_INVERT	IME コンポジションの場合は、選択内容を偽装します。
CFU_UNDERLINE	単一の実線で下線が付いたテキスト。
CFU_UNDERLINEDASH	ダッシュで下線が付いたテキスト。
CFU_UNDERLINEDASHDOT	点線と点線で下線が付いたテキスト。
CFU_UNDERLINEDASHDOTDOT	点線と二重点線で下線が付いたテキスト。
CFU_UNDERLINEDOTTED	点線で下線が付いたテキスト。 Microsoft Rich Edit 3.0 より前のバージョンでは、テキストは下線付きで表示されます。
CFU_UNDERLINEDOUBLE	二重線で下線が引いたテキスト。リッチエディットコントロールには、テキストが下線付きで表示されます。
CFU_UNDERLINEDOUBLEWAVE	CFU_UNDERLINEWAVEとして表示します。
CFU_UNDERLINEHAIRLINE	CFU_UNDERLINEとして表示します。
CFU_UNDERLINEHEAVYWAVE	CFU_UNDERLINEWAVEとして表示します。
CFU_UNDERLINELONGDASH	CFU_UNDERLINEDASHとして表示します。
CFU_UNDERLINENONE	下線なし。これが既定値です。
CFU_UNDERLINETHICK	CFU_UNDERLINEとして表示します。
CFU_UNDERLINETHICKDASH	CFU_UNDERLINEDASHとして表示します。
CFU_UNDERLINETHICKDASHDOT	CFU_UNDERLINEDASHDOTとして表示します。
CFU_UNDERLINETHICKDASHDOTDOT	CFU_UNDERLINEDASHDOTとして表示します。
CFU_UNDERLINETHICKDOTTED	CFU_UNDERLINEDOTとして表示します。
CFU_UNDERLINETHICKLONGDASH	CFU_UNDERLINEDASHとして表示します。
CFU_UNDERLINEWAVE	RichEdit 4.1 以降の: 波線で下線が引いたテキスト。
CFU_UNDERLINEWORD	RichEdit 4.1 以降の: 下線の単語のみ。リッチエディットコントロールには、テキストが下線付きで表示されます。

bAnimation

型: BYTE

テキストアニメーションの種類。この値は、リッチエディットコントロールによって表示されるテキストには影響しません。TOM インターフェイスとの互換性のために含まれています。このメンバーを使用するには、dwMask メンバーで CFM_ANIMATION フラグを設定します。

bRevAuthor

型: BYTE

リビジョンを作成する作成者を識別するインデックス。リッチエディットコントロールでは、作成者インデックスごとに異なるテキストの色が使用されます。このメンバーを使用するには、dwMask メンバーで CFM_REVAUTHOR フラグを設定します。

bUnderlineColor

型: BYTE

下線の色:

UnderlineColor_Black = 0x00;
UnderlineColor_Blue = 0x01;
UnderlineColor_Aqua = 0x02;
UnderlineColor_Lime = 0x03;
UnderlineColor_Fuchsia = 0x04;
UnderlineColor_Red = 0x05;
UnderlineColor_Yellow = 0x06;
UnderlineColor_White = 0x07;
UnderlineColor_Navy = 0x08;
UnderlineColor_Teal = 0x09;
UnderlineColor_Green = 0x0A;
UnderlineColor_Purple = 0x0B;
UnderlineColor_Maroon = 0x0C;
UnderlineColor_Olive = 0x0D;
UnderlineColor_DkGray = 0x0E;
UnderlineColor_LtGray = 0x0F;

備考

書式設定属性をオフにするには、dwMask で適切な値を設定しますが、dwEffectsで対応する値を設定しないでください。たとえば、斜体をオフにするには、CFM_ITALIC 設定しますが、CFE_ITALIC設定しません。

手記

richedit.h ヘッダーは、CHARFORMAT2をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルまたは実行時エラーが発生する不一致につながる可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

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

次の方法で共有

CHARFORMAT2A構造体 (richedit.h)

構文

継承

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース