次の方法で共有

CHARFORMAT2A構造 (リッチ エディット 2.0)

  • [アーティクル]

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

構文

typedef struct _charformat2a {
  UINT     cbSize;
  DWORD    dwMask;
  DWORD    dwEffects;
  LONG     yHeight;
  LONG     yOffset;
  COLORREF crTextColor;
  BYTE     bCharSet;
  BYTE     bPitchAndFamily;
  char     szFaceName[LF_FACESIZE];
  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;

メンバーズ

cbSize

型: UINT

構造体のサイズをバイト単位で指定します。 この構造体をリッチエディット コントロールに渡す前に、cbSize CHARFORMAT または CHARFORMAT2 構造体のサイズに設定します。 cbSize が CHARFORMAT 構造体のサイズと等しい場合、コントロールは CHARFORMAT メンバーのみを使用します。

dwMask

型: DWORD

有効な情報を含む CHARFORMAT2 構造体の部分を指定します。 dwMask メンバーは、2 セットのビット フラグからの値の組み合わせにすることができます。 1 つのセットは、有効な構造体メンバーを示します。 別のセットは、dwEffects メンバー内の有効な属性を示します。

次の値を設定して、dwEffects メンバーの有効な属性を示します。

価値 意味
CFM_ALL
 次の値の組み合わせ: CFM_EFFECTS | CFM_SIZE | CFM_FACE | CFM_OFFSET | CFM_CHARSET
CFM_ALL2
 次の値の組み合わせ: CFM_ALL | CFM_EFFECTS2 | CFM_BACKCOLOR | CFM_LCID | CFM_UNDERLINETYPE | CFM_WEIGHT | CFM_REVAUTHOR | CFM_SPACING | CFM_KERNING | CFM_STYLE | CFM_ANIMATION | CFM_COOKIE
CFM_ALLCAPS
 CFE_ALLCAPS 値は有効です。
CFM_EFFECTS
 次の値の組み合わせ: CFM_EFFECTS2 | CFM_FONTBOUND | CFM_EXTENDED | CFM_MATHNOBUILDUP | CFM_MATH | CFM_MATHORDINARY
CFM_BOLD
 CFE_BOLD 値は有効です。
CFM_COLOR
 CFE_AUTOCOLOR 値が有効であるか、crTextColor メンバーが有効です。
CFM_COOKIE
 dwCookie 値が有効です。
CFM_DISABLED
 CFE_DISABLED 値は有効です。
CFM_EXTENDED
 CFE_EXTENDED 値は有効です。
CFM_EFFECTS
 次の値の組み合わせ: CFM_BOLD | CFM_ITALIC | CFM_UNDERLINE | CFM_COLOR | CFM_STRIKEOUT | CFE_PROTECTED | CFM_LINK
CFM_EFFECTS2
 次の値の組み合わせ: CFM_EFFECTS | CFM_DISABLED | CFM_SMALLCAPS | CFM_ALLCAPS | CFM_HIDDEN | CFM_OUTLINE | CFM_SHADOW | CFM_EMBOSS | CFM_IMPRINT | CFM_REVISED | CFM_SUBSCRIPT | CFM_SUPERSCRIPT | CFM_BACKCOLOR
CFM_EMBOSS
 CFE_EMBOSS 値は有効です。
CFM_FONTBOUND
 CFE_FONTBOUND 値は有効です。
CFM_HIDDEN
 CFE_HIDDEN 値は有効です。
CFM_IMPRINT
 CFE_IMPRINT 値は有効です。
CFM_ITALIC
 CFE_ITALIC 値は有効です。
CFM_LINK
 CFE_LINK 値は有効です。
CFM_LINKPROTECTED
 CFE_LINKPROTECTED 値は有効です。
CFM_MATH
 CFE_MATH 値は有効です。
CFM_MATHNOBUILDUP
 CFE_MATHNOBUILDUP 値は有効です。
CFM_MATHORDINARY
 CFE_MATHORDINARY 値は有効です。
CFM_OUTLINE
 CFE_OUTLINE 値は有効です。
CFM_PROTECTED
 CFE_PROTECTED 値は有効です。
CFM_REVISED
 CFE_REVISION 値は有効です。
CFM_SHADOW
 CFE_SHADOW 値は有効です。
CFM_SMALLCAPS
 CFE_SMALLCAPS 値は有効です。
CFM_STRIKEOUT
 CFE_STRIKEOUT 値は有効です。
CFM_SUBSCRIPT
 CFE_SUBSCRIPT と CFE_SUPERSCRIPT の値は有効です。
CFM_SUPERSCRIPT
 CFE_SUBSCRIPT と CFE_SUPERSCRIPT の値は有効です。
CFM_UNDERLINE
 CFE_UNDERLINE 値は有効です。
 

有効な構造体メンバーを示すには、次の値を設定します。

価値 意味
CFM_ANIMATION
 bAnimation メンバーは有効です。
CFM_BACKCOLOR
 crBackColor メンバーが有効です。
CFM_CHARSET
 bCharSet メンバーが有効です。
CFM_COLOR
 dwEffects メンバーで CFE_AUTOCOLOR フラグが設定されていない限り、crTextColor メンバーは有効です。
CFM_FACE
 szFaceName メンバーが有効です。
CFM_KERNING
 wKerning メンバーは有効です。
CFM_LCID
 lcid メンバーが有効です。
CFM_OFFSET
 yOffset メンバーが有効です。
CFM_REVAUTHOR
 bRevAuthor メンバーが有効です。
CFM_SIZE
 yHeight メンバーは有効です。
CFM_SPACING
 sSpacing メンバーが有効です。
CFM_STYLE
 sStyle メンバーは有効です。
CFM_UNDERLINETYPE
 bUnderlineType メンバーが有効です。
CFM_WEIGHT
 wWeight メンバーが有効です。

dwEffects

型: DWORD

文字効果を指定するビット フラグのセット。 一部のフラグは、Microsoft Text Object Model (TOM) インターフェイスとの互換性のためにのみ含まれています。リッチ エディット コントロールは値を格納しますが、テキストの表示には使用しません。

このメンバーは、次の値の組み合わせにすることができます。

価値 意味
CFE_ALLCAPS
 文字はすべて大文字です。 この値は、コントロールがテキストを表示する方法には影響しません。 この値は、Microsoft Rich Edit 3.0 より前のバージョンにのみ適用されます。
CFE_AUTOBACKCOLOR
 背景色は、GetSysColor(COLOR_WINDOW) 戻り値です。 このフラグが設定されている場合、crBackColor メンバー は無視されます。
CFE_AUTOCOLOR
 テキストの色は、GetSysColor(COLOR_WINDOWTEXT) 戻り値です。 このフラグが設定されている場合、crTextColor メンバー は無視されます。
CFE_BOLD
 文字は太字です。
CFE_DISABLED
 文字は影付きで表示され、3/4 ポイントまたは 1 ピクセルのどちらか大きい方でオフセットされます。
CFE_EMBOSS
 文字はエンボス加工されています。 この値は、コントロールによるテキストの表示方法には影響しません。
CFE_EXTENDED
 これらの文字は、スクリプトのあまり一般的でないメンバーです。 スクリプトをサポートするフォントは、そのような文字のグリフがあるかどうかを確認する必要があります。
CFE_FONTBOUND
 フォントは、アクティブなフォントが文字をサポートしていないため、リッチ エディット コントロールによって選択されます。 このプロセスはフォント バインドと呼ばれます。
CFE_HIDDEN
 Microsoft Rich Edit 3.0 以降では、文字は表示されません。
CFE_IMPRINT
 文字はインプリント文字として表示されます。 この値は、コントロールによるテキストの表示方法には影響しません。
CFE_ITALIC
 文字は斜体です。
CFE_LINK
 リッチ エディット コントロールは、マウス ポインターがテキストの上にあり、CFE_LINK 効果がある状態でマウス メッセージを受信したときに、EN_LINK 通知コードを送信できます。
CFE_LINKPROTECTED
 文字はフレンドリ名リンクの一部です。
CFE_MATH
 文字は数値演算領域にあります。
CFE_MATHNOBUILDUP
 文字は数学のビルドアップには含まれません。 たとえば、/に適用する場合、/は分数を構築するために使用されません。
CFE_MATHORDINARY
 文字は、数値演算領域内で通常のテキストとして表示されます。
CFE_OUTLINE
 文字は、アウトライン文字として表示されます。 この値は、コントロールによるテキストの表示方法には影響しません。
CFE_PROTECTED
 文字は保護されています。変更しようとすると、EN_PROTECTED 通知コードが発生します。
CFE_REVISED
 文字は変更済みとしてマークされます。
CFE_SHADOW
 文字は影付き文字として表示されます。 この値は、コントロールによるテキストの表示方法には影響しません。
CFE_SMALLCAPS
 文字は小文字です。 この値は、コントロールによるテキストの表示方法には影響しません。
CFE_STRIKEOUT
 文字が取り消されます。
CFE_SUBSCRIPT
 文字は下付き文字です。 CFE_SUPERSCRIPT 値と CFE_SUBSCRIPT 値は相互に排他的です。 どちらの値でも、コントロールはオフセットと小さいフォント サイズを自動的に計算します。 または、yHeight と yOffset メンバーを使用して、下付き文字と上付き文字のフォント サイズとオフセットを明示的に指定することもできます。
CFE_SUPERSCRIPT
 文字は上付き文字です。
CFE_UNDERLINE
 文字には下線が付けられます。

yHeight

型: long

文字の高さを twip 単位で指定します (1/1440 インチ、プリンターのポイントの 1/20)。 このメンバーを使用するには、dwMask メンバーで CFM_SIZE フラグを設定します。

yOffset

型: long

ベースラインからの文字オフセット (twip 単位)。 このメンバーの値が正の場合、文字は上付き文字です。値が負の場合、文字は下付き文字です。 このメンバーを使用するには、dwMask メンバーで CFM_OFFSET フラグを設定します。

crTextColor

型: COLORREF

テキストの色。 このメンバーを使用するには、dwMask メンバーで CFM_COLOR フラグを設定します。 CFE_AUTOCOLOR 文字効果が指定されている場合、このメンバーは無視されます。 COLORREFを生成するには、RGB マクロを使用します。

bCharSet

型: BYTE

文字セット値。 LOGFONT 構造体の lfCharSet メンバーに指定された値のいずれかを指定できます。 このメンバーを使用するには、dwMask メンバーで CFM_CHARSET フラグを設定します。

bPitchAndFamily

型: BYTE

フォント ファミリとピッチを指定します。 このメンバーは、LOGFONT 構造体の lfPitchAndFamily メンバーと同じです。

szFaceName[LF_FACESIZE]

型: TCHAR[LF_FACESIZE]

フォント名を指定する null で終わる文字配列。 このメンバーを使用するには、dwMask メンバーで CFM_FACE フラグを設定します。

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 である必要があります。

型: 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設定しません。

必要条件

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

関連項目

CHARFORMAT を する

COLORREF

EM_GETCHARFORMAT

EM_SETCHARFORMAT

EN_PROTECTED

GetSysColor を する

LOGFONT の

RGB を する