CHARFORMAT2A 構造体 (richedit.h)

  • [アーティクル]

リッチ エディット コントロールの文字書式に関する情報が含まれています。 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 (デスクトップ アプリのみ)
Header richedit.h

こちらもご覧ください

Charformat

COLORREF

EM_GETCHARFORMAT

EM_SETCHARFORMAT

EN_PROTECTED

GetSysColor

Logfont

RGB