CHARFORMAT2A 구조체(richedit.h)
서식 있는 편집 컨트롤의 문자 서식에 대한 정보를 포함합니다. CHARFORMAT2는 CHARFORMAT 구조체의 Microsoft Rich Edit 2.0 확장입니다. Microsoft Rich Edit 2.0에서는 EM_GETCHARFORMAT 및 EM_SETCHARFORMAT 메시지와 함께 구조체를 사용할 수 있습니다.
Syntax
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
문자 사이의 가로 공간(트윅)입니다. 이 값은 서식 있는 편집 컨트롤에 의해 표시되는 텍스트에 영향을 주지 않습니다. Windows TOM 인터페이스와의 호환성을 위해 포함됩니다. 이 멤버를 사용하려면 dwMask 멤버에서 CFM_SPACING 플래그를 설정합니다.
crBackColor
형식: COLORREF
배경색. 이 멤버를 사용하려면 dwMask 멤버에서 CFM_BACKCOLOR 플래그를 설정합니다. CFE_AUTOBACKCOLOR 문자 효과를 지정하면 이 멤버는 무시됩니다. 를 생성하려면 매크로를 사용합니다.
lcid
형식: LCID
아래쪽 단어의 언어 식별자와 상위 단어의 정렬 식별자 및 예약된 값을 포함하는 32비트 로캘 식별자입니다. 이 멤버는 서식 있는 편집 컨트롤에서 표시하는 텍스트에 영향을 주지 않지만 맞춤법 및 문법 검사기를 사용하여 언어 종속 문제를 처리할 수 있습니다. 매크로를 사용하여 LCID 값을 만들 수 있습니다. 이 멤버를 사용하려면 dwMask 멤버에서 CFM_LCID 플래그를 설정합니다.
dwReserved
형식: DWORD
예약; 값은 0이어야 합니다.
dwCookie
형식: DWORD
클라이언트 쿠키. 이 멤버는 서식 있는 편집 컨트롤에 불투명합니다.
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 설정하지 마세요.
참고
richedit.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 CHARFORMAT2 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 머리글 | richedit.h |
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기