CHARFORMAT2A 구조체(서식 있는 편집 2.0)
서식 있는 편집 컨트롤의 문자 서식에 대한 정보를 포함합니다. CHARFORMAT2CHARFORMAT 구조의 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
구조체의 크기(바이트)를 지정합니다. 이 구조를 풍부한 편집 컨트롤에 전달하기 전에 cbSizeCHARFORMAT 또는 CHARFORMAT2 구조체의 크기로 설정합니다. cbSizeCHARFORMAT 구조체의 크기와 같으면 컨트롤은 CHARFORMAT 멤버만 사용합니다.
dwMask
형식: DWORD
유효한 정보를 포함하는 CHARFORMAT2 구조체의 부분을 지정합니다. dwMask 멤버는 두 비트 플래그 집합의 값 조합일 수 있습니다. 하나의 집합은 유효한 구조체 멤버를 나타냅니다. 또 다른 집합은 dwEffects 멤버의 유효한 특성을 나타냅니다.
다음 값을 설정하여 dwEffects 멤버의 유효한 특성을 나타냅니다.
유효한 구조체 멤버를 나타내려면 다음 값을 설정합니다.
dwEffects
형식: DWORD
문자 효과를 지정하는 비트 플래그 집합입니다. 일부 플래그는 TOM(Microsoft Text Object Model) 인터페이스와의 호환성을 위해서만 포함됩니다. 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트를 표시하는 데는 사용하지 않습니다.
이 멤버는 다음 값의 조합일 수 있습니다.
| 값 | 의미 |
|---|---|
|
문자는 모두 대문자입니다. 이 값은 컨트롤이 텍스트를 표시하는 방식에 영향을 주지 않습니다. 이 값은 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
문자 높이(1/1440인치 또는 프린터 점 1/20)로 지정합니다. 이 멤버를 사용하려면 dwMask 멤버에서 CFM_SIZE 플래그를 설정합니다.
yOffset
형식: LONG
기준선의 문자 오프셋(twips)입니다. 이 멤버의 값이 양수이면 문자는 위 첨자입니다. 값이 음수이면 문자는 아래 첨자입니다. 이 멤버를 사용하려면 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
문자 사이의 가로 간격(트립)입니다. 이 값은 서식 있는 편집 컨트롤에 의해 표시되는 텍스트에 영향을 주지 않습니다. 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
클라이언트 쿠키. 이 멤버는 서식 있는 편집 컨트롤에 불투명합니다.
sStyle
형식: SHORT
문자 스타일 핸들입니다. 이 값은 서식 있는 편집 컨트롤에 의해 표시되는 텍스트에 영향을 주지 않습니다. WindowsTOM 인터페이스와의 호환성을 위해 포함됩니다. 이 멤버를 사용하려면 dwMask 멤버에서 CFM_STYLE 플래그를 설정합니다. 자세한 내용은 TOM 설명서를 참조하세요.
wKerning
형식: WORD
문자(yHeight)를 커닝할 글꼴 크기의 값입니다. 이 값은 서식 있는 편집 컨트롤에 의해 표시되는 텍스트에 영향을 주지 않습니다. TOM 인터페이스와의 호환성을 위해 포함됩니다. 이 멤버를 사용하려면 dwMask 멤버에서 CFM_KERNING 플래그를 설정합니다.
bUnderlineType
형식: BYTE
밑줄 형식을 지정합니다. 이 멤버를 사용하려면 dwMask 멤버에서 CFM_UNDERLINETYPE 플래그를 설정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.
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
GetSysColor
LOGFONT
RGB