描述
CHARFORMAT结构包含有关丰富编辑控件中字符格式设置的信息。
Rich Edit 2.0：CHARFORMAT2结构是CHARFORMAT结构的Microsoft Rich Edit 2.0扩展程序。 Rich Edit 2.0及更高版本允许您使用EM_GETCHARFORMAT和EM_SETCHARFORMAT邮件中的任一结构。
C/C++ 语法
typedef struct _charformat { UINT cbSize; DWORD dwMask; DWORD dwEffects; LONG yHeight; LONG yOffset; COLORREF crTextColor; BYTE bCharSet; BYTE bPitchAndFamily; TCHAR szFaceName[LF_FACESIZE]; } CHARFORMAT; |
PB语法
TYPE CHARFORMATA cbSize AS DWORD dwMask AS DWORD dwEffects AS DWORD yHeight AS LONG yOffset AS LONG crTextColor AS DWORD bCharSet AS BYTE bPitchAndFamily AS BYTE szFaceName AS ASCIIZ * %LF_FACESIZE wFiller AS WORD END TYPE |
Unicode版本:
TYPE CHARFORMATW BYTE cbSize AS DWORD dwMask AS DWORD dwEffects AS DWORD yHeight AS LONG yOffset AS LONG crTextColor AS DWORD bCharSet AS BYTE bPitchAndFamily AS BYTE szFaceName AS WSTRINGZ * %LF_FACESIZE wFiller AS WORD END TYPE |
成员
cbSize
指定结构的字节大小。 在将结构传递给rich编辑控件之前，必须设置此成员。
dwMask
成员包含有效信息或属性设置。 该成员可以为零，一个或多于一个以下值。
CFM_BOLD
dwEffects成员的CFE_BOLD值有效。
CFM_CHARSET
bCharSet成员有效。
CFM_COLOR
crTextColor成员和dwEffects成员的CFE_AUTOCOLOR值有效。
CFM_FACE
szFaceName成员有效。
CFM_ITALIC
dwEffects成员的CFE_ITALIC值有效。
CFM_OFFSET
yOffset成员有效。
CFM_PROTECTED
dwEffects成员的CFE_PROTECTED值有效。
CFM_SIZE
yHeight成员有效。
CFM_STRIKEOUT
dwEffects成员的CFE_STRIKEOUT值有效。
CFM_UNDERLINE.
dwEffects成员的CFE_UNDERLINE值有效。
dwEffects
字符效果。 该成员可以是以下值的组合。
CFE_AUTOCOLOR
文本颜色是返回值GetSysColor（COLOR_WINDOWTEXT）。
CFE_BOLD
人物大胆
CFE_DISABLED
RichEdit 2.0及更高版本：字符显示为以3/4点或一个像素偏移的阴影（以较大者为准）。
CFE_ITALIC
字符是斜体
CFE_STRIKEOUT
人物被打了
CFE_UNDERLINE
字符加下划线。
CFE_PROTECTED
人物受到保护; 尝试修改它们将导致EN_PROTECTED通知消息。
yHeight
字符高度，缇（1/1440英寸或打印机点数的1/20）。
yOffset
字符偏移，以缇为基准。 如果这个成员的价值是积极的，那么这个角色就是上标; 如果是负数，则字符是下标。
crTextColor
文字颜色。 如果指定了CFE_AUTOCOLOR字符效果，则忽略该成员。 要生成COLORREF，请使用RGB功能。
bCharSet
字符集值。 bCharSet成员可以是为LOGFONT结构lfCharSet成员指定的值之一。 如果目标字符无效，Rich Edit 3.0可能会覆盖此值。
bPitchAndFamily
字体系和音调。 该成员与LOGFONT结构的lfPitchAndFamily成员相同。
szFaceName
指定字体名称的Null终止字符数组。
备注
要关闭格式化属性，请在dwMask中设置适当的值，但不要在dwEffects中设置相应的值。 例如，要关闭斜体，请设置CFM_ITALIC，但不要设置CFE_ITALIC。
最低操作系统
Windows 95，Windows NT 4.0。
引用文件 #INCLUDE Once
RichEdit.inc