Share via

CHARFORMAT2A 구조체(서식 있는 편집 2.0)

  • 아티클

서식 있는 편집 컨트롤의 문자 서식에 대한 정보를 포함합니다. CHARFORMAT2는 CHARFORMAT 구조체의 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

구조체의 크기(바이트)를 지정합니다. 이 구조를 풍부한 편집 컨트롤에 전달하기 전에 cbSize 를 CHARFORMAT 또는 CHARFORMAT2 구조체의 크기로 설정합니다. cbSize가 CHARFORMAT 구조체의 크기와 같으면 컨트롤은 CHARFORMAT 멤버만 사용합니다.

dwMask

형식: DWORD

유효한 정보를 포함하는 CHARFORMAT2 구조체의 부분을 지정합니다. dwMask 멤버는 두 비트 플래그 집합의 값 조합일 수 있습니다. 하나의 집합은 유효한 구조체 멤버를 나타냅니다. 또 다른 집합은 dwEffects 멤버의 유효한 특성을 나타냅니다.

다음 값을 설정하여 dwEffects 멤버의 유효한 특성을 나타냅니다.

값 의미
CFM_ALL
 다음 값의 조합: CFM_EFFECTS CFM_SIZE | CFM_FACE | CFM_OFFSET | CFM_CHARSET |
CFM_ALL2
 다음 값의 조합: CFM_ALL CFM_EFFECTS2 | CFM_BACKCOLOR | CFM_LCID | CFM_UNDERLINETYPE CFM_WEIGHT | | CFM_REVAUTHOR | CFM_SPACING CFM_KERNING | | CFM_STYLE | CFM_ANIMATION CFM_COOKIE | |
CFM_ALLCAPS
 CFE_ALLCAPS 값이 유효합니다.
CFM_EFFECTS
 다음 값의 조합: CFM_EFFECTS2 CFM_FONTBOUND | CFM_EXTENDED | CFM_MATHNOBUILDUP | CFM_MATH | CFM_MATHORDINARY |
CFM_BOLD
 CFE_BOLD 값이 유효합니다.
CFM_COLOR
 CFE_AUTOCOLOR 값이 유효하거나 crTextColor 멤버가 유효합니다.
CFM_COOKIE
 dwCookie 값이 유효합니다.
CFM_DISABLED
 CFE_DISABLED 값이 유효합니다.
CFM_EXTENDED
 CFE_EXTENDED 값이 유효합니다.
CFM_EFFECTS
 다음 값의 조합: CFM_BOLD CFM_ITALIC | CFM_UNDERLINE | CFM_COLOR | CFM_STRIKEOUT | CFE_PROTECTED | CFM_LINK |
CFM_EFFECTS2
 다음 값의 조합: CFM_EFFECTS CFM_DISABLED | CFM_SMALLCAPS | CFM_ALLCAPS | CFM_HIDDEN | CFM_OUTLINE | CFM_SHADOW | CFM_EMBOSS CFM_IMPRINT | CFM_REVISED | | CFM_SUBSCRIPT | | CFM_SUPERSCRIPT | CFM_BACKCOLOR
CFM_EMBOSS
 CFE_EMBOSS 값이 유효합니다.
CFM_FONTBOUND
 CFE_FONTBOUND 값이 유효합니다.
CFM_HIDDEN
 CFE_HIDDEN 값이 유효합니다.
CFM_IMPRINT
 CFE_IMPRINT 값이 유효합니다.
CFM_ITALIC
 CFE_ITALIC 값이 유효합니다.
CFM_LINK
 CFE_LINK 값이 유효합니다.
CFM_LINKPROTECTED
 CFE_LINKPROTECTED 값이 유효합니다.
CFM_MATH
 CFE_MATH 값이 유효합니다.
CFM_MATHNOBUILDUP
 CFE_MATHNOBUILDUP 값이 유효합니다.
CFM_MATHORDINARY
 CFE_MATHORDINARY 값이 유효합니다.
CFM_OUTLINE
 CFE_OUTLINE 값이 유효합니다.
CFM_PROTECTED
 CFE_PROTECTED 값이 유효합니다.
CFM_REVISED
 CFE_REVISION 값이 유효합니다.
CFM_SHADOW
 CFE_SHADOW 값이 유효합니다.
CFM_SMALLCAPS
 CFE_SMALLCAPS 값이 유효합니다.
CFM_STRIKEOUT
 CFE_STRIKEOUT 값이 유효합니다.
CFM_SUBSCRIPT
 CFE_SUBSCRIPT 및 CFE_SUPERSCRIPT 값이 유효합니다.
CFM_SUPERSCRIPT
 CFE_SUBSCRIPT 및 CFE_SUPERSCRIPT 값이 유효합니다.
CFM_UNDERLINE
 CFE_UNDERLINE 값이 유효합니다.
 

유효한 구조체 멤버를 나타내려면 다음 값을 설정합니다.

값 의미
CFM_ANIMATION
 bAnimation 멤버가 유효합니다.
CFM_BACKCOLOR
 crBackColor 멤버가 유효합니다.
CFM_CHARSET
 bCharSet 멤버가 유효합니다.
CFM_COLOR
 dwEffects 멤버에서 CFE_AUTOCOLOR 플래그를 설정하지 않는 한 crTextColor 멤버는 유효합니다.
CFM_FACE
 szFaceName 멤버가 유효합니다.
CFM_KERNING
 wKerning 멤버가 유효합니다.
CFM_LCID
 lcid 멤버가 유효합니다.
CFM_OFFSET
 yOffset 멤버가 유효합니다.
CFM_REVAUTHOR
 bRevAuthor 멤버가 유효합니다.
CFM_SIZE
 yHeight 멤버가 유효합니다.
CFM_SPACING
 sSpacing 멤버가 유효합니다.
CFM_STYLE
 sStyle 멤버가 유효합니다.
CFM_UNDERLINETYPE
 bUnderlineType 멤버가 유효합니다.
CFM_WEIGHT
 wWeight 멤버가 유효합니다.

dwEffects

형식: DWORD

문자 효과를 지정하는 비트 플래그 집합입니다. 일부 플래그는 TOM(Microsoft Text Object Model ) 인터페이스와의 호환성을 위해서만 포함됩니다. 서식 있는 편집 컨트롤은 값을 저장하지만 텍스트를 표시하는 데는 사용하지 않습니다.

이 멤버는 다음 값의 조합일 수 있습니다.

값 의미
CFE_ALLCAPS
 문자는 모두 대문자입니다. 값은 컨트롤이 텍스트를 표시하는 방식에 영향을 주지 않습니다. 이 값은 Microsoft Rich Edit 3.0 이전 버전에만 적용됩니다.
CFE_AUTOBACKCOLOR
 배경색은 GetSysColor(COLOR_WINDOW)의 반환 값입니다. 이 플래그를 설정하면 crBackColor 멤버가 무시됩니다.
CFE_AUTOCOLOR
 텍스트 색은 GetSysColor(COLOR_WINDOWTEXT)의 반환 값입니다. 이 플래그를 설정하면 crTextColor 멤버가 무시됩니다.
CFE_BOLD
 문자는 굵게 표시됩니다.
CFE_DISABLED
 문자는 3/4포인트 또는 1픽셀로 오프셋되는 그림자와 함께 표시됩니다.
CFE_EMBOSS
 문자가 엠보싱됩니다. 값은 컨트롤이 텍스트를 표시하는 방식에 영향을 주지 않습니다.
CFE_EXTENDED
 문자는 스크립트의 덜 일반적인 멤버입니다. 스크립트를 지원하는 글꼴은 해당 문자에 대한 문자 모양이 있는 경우 검사 합니다.
CFE_FONTBOUND
 현재 글꼴이 문자를 지원하지 않으므로 서식 있는 편집 컨트롤에서 글꼴을 선택합니다. 이 프로세스를 글꼴 바인딩이라고 합니다.
CFE_HIDDEN
 Microsoft Rich Edit 3.0 이상의 경우 문자가 표시되지 않습니다.
CFE_IMPRINT
 문자는 각인된 문자로 표시됩니다. 값은 컨트롤이 텍스트를 표시하는 방식에 영향을 주지 않습니다.
CFE_ITALIC
 문자는 기울임꼴입니다.
CFE_LINK
 서식 있는 편집 컨트롤은 마우스 포인터가 CFE_LINK 효과와 함께 텍스트 위에 있는 동안 마우스 메시지를 받을 때 EN_LINK 알림 코드를 보낼 수 있습니다.
CFE_LINKPROTECTED
 문자는 친숙한 이름 링크의 일부입니다.
CFE_MATH
 문자는 수학 영역에 있습니다.
CFE_MATHNOBUILDUP
 문자는 수학 빌드에 참여하지 않습니다. 예를 들어 / 에 적용하면 / 는 분수를 작성하는 데 사용되지 않습니다.
CFE_MATHORDINARY
 문자는 수학 영역 내에서 일반 텍스트로 표시됩니다.
CFE_OUTLINE
 문자는 윤곽선 문자로 표시됩니다. 값은 컨트롤이 텍스트를 표시하는 방식에 영향을 주지 않습니다.
CFE_PROTECTED
 문자는 보호됩니다. 수정하려고 하면 EN_PROTECTED 알림 코드가 발생합니다.
CFE_REVISED
 문자는 수정된 것으로 표시됩니다.
CFE_SHADOW
 문자는 그림자 문자로 표시됩니다. 값은 컨트롤이 텍스트를 표시하는 방식에 영향을 주지 않습니다.
CFE_SMALLCAPS
 문자는 작은 대문자로 표시됩니다. 값은 컨트롤이 텍스트를 표시하는 방식에 영향을 주지 않습니다.
CFE_STRIKEOUT
 문자가 쳐집니다.
CFE_SUBSCRIPT
 문자는 아래 첨자입니다. CFE_SUPERSCRIPT 및 CFE_SUBSCRIPT 값은 상호 배타적입니다. 두 값에 대해 컨트롤은 오프셋과 더 작은 글꼴 크기를 자동으로 계산합니다. 또는 yHeight 및 yOffset 멤버를 사용하여 아래 첨자 및 위 첨자 문자의 글꼴 크기와 오프셋을 명시적으로 지정할 수 있습니다.
CFE_SUPERSCRIPT
 문자는 위 첨자입니다.
CFE_UNDERLINE
 문자에 밑줄이 표시됩니다.

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

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

요구 사항

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

추가 정보

CHARFORMAT

COLORREF

EM_GETCHARFORMAT

EM_SETCHARFORMAT

EN_PROTECTED

GetSysColor

Logfont

RGB