CHARFORMAT2W 構造体 (Rich Edit 2.0)
リッチ エディット コントロールの文字書式に関する情報が含まれています。 CHARFORMAT2 は、 CHARFORMAT 構造体の Microsoft Rich Edit 2.0 拡張機能です。 Microsoft Rich Edit 2.0 では、 メッセージのEM_GETCHARFORMAT と EM_SETCHARFORMAT のいずれかの構造を使用できます。
構文
typedef struct _charformat2w {
UINT cbSize;
DWORD dwMask;
DWORD dwEffects;
LONG yHeight;
LONG yOffset;
COLORREF crTextColor;
BYTE bCharSet;
BYTE bPitchAndFamily;
WCHAR 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;
} CHARFORMAT2W;
メンバー
cbSize
型: UINT
構造体のサイズをバイト単位で指定します。 この構造体をリッチ エディット コントロールに渡す前に、 cbSize を CHARFORMAT または CHARFORMAT2 構造体のサイズに設定します。 cbSize がCHARFORMAT 構造体のサイズと等しい場合、コントロールは CHARFORMAT メンバーのみを使用します。
dwMask
型: DWORD
有効な情報を含む CHARFORMAT2 構造体の部分を指定します。 dwMask メンバーには、2 つのビット フラグ セットの値を組み合わせて使用できます。 1 つのセットは、有効な構造体メンバーを示します。 別のセットは、 dwEffects メンバーの有効な属性を示します。
dwEffects メンバーの有効な属性を示すように、次の値を設定します。
有効な構造体メンバーを示すには、次の値を設定します。
dwEffects
型: DWORD
文字効果を指定するビット フラグのセット。 一部のフラグは、Microsoft Text Object Model (TOM) インターフェイスとの互換性のためにのみ含まれています。リッチ エディット コントロールは値を格納しますが、テキストの表示には使用しません。
このメンバーには、次の値の組み合わせを指定できます。
値 | 意味 |
---|---|
|
文字はすべて大文字です。 この値は、コントロールのテキストの表示方法には影響しません。 この値は、Microsoft Rich Edit 3.0 より前のバージョンにのみ適用されます。 |
|
背景色は GetSysColor(COLOR_WINDOW) の戻り値です。 このフラグが設定されている場合、 crBackColor メンバーは無視されます。 |
|
テキストの色は GetSysColor(COLOR_WINDOWTEXT) の戻り値です。 このフラグが設定されている場合、 crTextColor メンバーは無視されます。 |
|
文字は太字です。 |
|
文字は影付きで表示され、3/4 ポイントまたは 1 ピクセル(どちらか大きい方)でオフセットされます。 |
|
文字はエンボス加工されます。 この値は、コントロールによるテキストの表示方法には影響しません。 |
|
これらの文字は、スクリプトのあまり一般的でないメンバーです。 スクリプトをサポートするフォントは、そのような文字のグリフがある場合にチェックする必要があります。 |
|
アクティブなフォントでは文字がサポートされていないため、リッチ エディット コントロールによってフォントが選択されます。 このプロセスは、フォント バインドと呼ばれます。 |
|
Microsoft Rich Edit 3.0 以降では、文字は表示されません。 |
|
文字はインプリント文字として表示されます。 この値は、コントロールによるテキストの表示方法には影響しません。 |
|
文字は斜体です。 |
|
リッチ エディット コントロールは、 マウス ポインターがCFE_LINK 効果を持つテキストの上にある間に、マウス メッセージを受信したときに EN_LINK 通知コードを送信できます。 |
|
文字は、フレンドリ名リンクの一部です。 |
|
文字は数学領域にあります。 |
|
文字は数学のビルドアップには参加しません。 たとえば、 /に適用した場合、 / は分数を構築するために使用されません。 |
|
文字は、数値演算領域内で通常のテキストとして表示されます。 |
|
文字はアウトライン文字として表示されます。 この値は、コントロールによるテキストの表示方法には影響しません。 |
|
文字は保護されています。変更しようとすると、 EN_PROTECTED 通知コードが発生します。 |
|
文字は変更済みとしてマークされます。 |
|
文字は影付き文字として表示されます。 この値は、コントロールによるテキストの表示方法には影響しません。 |
|
文字は小文字です。 この値は、コントロールによるテキストの表示方法には影響しません。 |
|
文字が三振されます。 |
|
文字は下付き文字です。 CFE_SUPERSCRIPTとCFE_SUBSCRIPTの値は相互に排他的です。 両方の値について、コントロールはオフセットと小さいフォント サイズを自動的に計算します。 または、 yHeight メンバーと yOffset メンバーを使用して、下付き文字と上付き文字のフォント サイズとオフセットを明示的に指定することもできます。 |
|
文字は上付き文字です。 |
|
文字には下線が付いている。 |
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 である必要があります。
dwCookie
型: DWORD
クライアント Cookie。 このメンバーは、リッチ エディット コントロールに対して不透明です。
sStyle
種類: SHORT
文字スタイル ハンドル。 この値は、リッチ エディット コントロールによって表示されるテキストには影響しません。WindowsTOM インターフェイスとの互換性のために含まれています。 このメンバーを使用するには、dwMask メンバーで CFM_STYLE フラグを設定します。 詳細については、TOM のドキュメントを参照してください。
wKerning
種類: WORD
文字をカーニングするフォント サイズの値 (yHeight)。 この値は、リッチ エディット コントロールによって表示されるテキストには影響しません。TOM インターフェイスとの互換性のために含まれています。 このメンバーを使用するには、dwMask メンバーで CFM_KERNING フラグを設定します。
bUnderlineType
型: BYTE
下線の種類を指定します。 このメンバーを使用するには、dwMask メンバーで CFM_UNDERLINETYPE フラグを設定します。 このメンバーには、次のいずれかの値を指定できます。
値 | 意味 |
---|---|
|
構造体は 、CHARFORMAT のビット下線を CHARFORMAT2にマップします (つまり、このテキストに対して CHARFORMAT 型の下線を実行します)。 |
|
IME コンポジションの場合は、選択内容を偽にします。 |
|
単一の実線で下線が引かれたテキスト。 |
|
ダッシュで下線が付いたテキスト。 |
|
点線と点線で下線が付いたテキスト。 |
|
点線と二重点線で下線が付いたテキスト。 |
|
点線で下線が付いたテキスト。 Microsoft Rich Edit 3.0 より前のバージョンの場合、テキストは実線で表示されます。 |
|
二重線で下線が引かれたテキスト。 リッチ エディット コントロールでは、テキストに下線が実線で表示されます。 |
|
CFU_UNDERLINEWAVEとして表示します。 |
|
CFU_UNDERLINEとして表示します。 |
|
CFU_UNDERLINEWAVEとして表示します。 |
|
CFU_UNDERLINEDASHとして表示します。 |
|
下線なし。 既定値です。 |
|
CFU_UNDERLINEとして表示します。 |
|
CFU_UNDERLINEDASHとして表示します。 |
|
CFU_UNDERLINEDASHDOTとして表示します。 |
|
CFU_UNDERLINEDASHDOTとして表示します。 |
|
CFU_UNDERLINEDOTとして表示します。 |
|
CFU_UNDERLINEDASHとして表示します。 |
|
RichEdit 4.1 以降: 波線で下線が付いたテキスト。 |
|
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 (デスクトップ アプリのみ) |
Header | richedit.h |
こちらもご覧ください
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示