다음을 통해 공유

CHARFORMAT2A 구조체(richedit.h)

  • 아티클

서식 있는 편집 컨트롤의 문자 서식에 대한 정보를 포함합니다. CHARFORMAT2CHARFORMAT 구조의 Microsoft Rich Edit 2.0 확장입니다. Microsoft Rich Edit 2.0을 사용하면 EM_GETCHARFORMAT 및 EM_SETCHARFORMAT 메시지와 함께 구조를 사용할 수 있습니다.

통사론

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 플래그를 설정합니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값 의미
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설정하지 않습니다.

메모

richedit.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 CHARFORMAT2 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
헤더 richedit.h

참고 항목

CHARFORMAT

COLORREF

EM_GETCHARFORMAT

EM_SETCHARFORMAT

EN_PROTECTED

GetSysColor

LOGFONT

RGB