CHARFORMATA 구조체(richedit.h)

  • 아티클

서식 있는 편집 컨트롤의 문자 서식에 대한 정보를 포함합니다.

리치 편집 2.0:CHARFORMAT2 구조체는 CHARFORMAT 구조체의 Microsoft Rich Edit 2.0 확장입니다. Microsoft Rich Edit 2.0 이상에서는 EM_GETCHARFORMAT 및 EM_SETCHARFORMAT 메시지와 함께 구조를 사용할 수 있습니다.

구문

typedef struct _charformat {
  UINT     cbSize;
  DWORD    dwMask;
  DWORD    dwEffects;
  LONG     yHeight;
  LONG     yOffset;
  COLORREF crTextColor;
  BYTE     bCharSet;
  BYTE     bPitchAndFamily;
  char     szFaceName[LF_FACESIZE];
} CHARFORMATA;

멤버

cbSize

형식: UINT

지정된 구조체의 크기(바이트)입니다. 구조체를 서식 있는 편집 컨트롤에 전달하기 전에 이 멤버를 설정해야 합니다.

dwMask

형식: DWORD

설정할 유효한 정보 또는 특성을 포함하는 멤버입니다. 이 멤버는 0, 1 또는 다음 값 중 하나 이상일 수 있습니다.

값 의미
CFM_ALL
 Windows 8: 다음 값의 조합: CFM_EFFECTS | CFM_SIZE | CFM_FACE | CFM_OFFSET | CFM_CHARSET
CFM_BOLD
 dwEffects 멤버의 CFE_BOLD 값이 유효합니다.
CFM_CHARSET
 bCharSet 멤버가 유효합니다.
CFM_COLOR
 crTextColor 멤버 및 dwEffects 멤버의 CFE_AUTOCOLOR 값이 유효합니다.
CFM_EFFECTS
 Windows 8: 다음 값의 조합: CFM_BOLD | CFM_ITALIC | CFM_UNDERLINE | CFM_COLOR | CFM_STRIKEOUT | CFE_PROTECTED | CFM_LINK
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

형식: DWORD

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

값 의미
CFE_AUTOCOLOR
 텍스트 색은 GetSysColor(COLOR_WINDOWTEXT)의 반환 값입니다.
CFE_BOLD
 문자는 굵게 표시됩니다.
CFE_DISABLED
 RichEdit 2.0 이상: 문자는 3/4포인트 또는 1픽셀로 오프셋되는 그림자와 함께 표시됩니다.
CFE_ITALIC
 문자는 기울임꼴입니다.
CFE_STRIKEOUT
 문자가 맞습니다.
CFE_UNDERLINE
 문자에 밑줄이 표시됩니다.
CFE_PROTECTED
 문자는 보호됩니다. 수정하려고 하면 EN_PROTECTED 알림 코드가 발생합니다.

yHeight

형식: LONG

문자 높이(1/1440인치 또는 프린터 점 1/20)입니다.

yOffset

형식: LONG

기준선의 문자 오프셋(twips)입니다. 이 멤버의 값이 양수이면 문자는 위 첨자입니다. 음수이면 문자는 아래 첨자입니다.

crTextColor

형식: COLORREF

텍스트 색입니다. CFE_AUTOCOLOR 문자 효과가 지정된 경우 이 멤버는 무시됩니다. COLORREF를 생성하려면 RGB 매크로를 사용합니다.

bCharSet

형식: BYTE

문자 집합 값입니다. bCharSet 멤버는 LOGFONT 구조체의 lfCharSet 멤버에 대해 지정된 값 중 하나일 수 있습니다. Microsoft Rich Edit 3.0은 대상 문자에 유효하지 않은 경우 이 값을 재정의할 수 있습니다.

bPitchAndFamily

형식: BYTE

글꼴 패밀리 및 피치. 이 멤버는 LOGFONT 구조체의 lfPitchAndFamily 멤버와 동일합니다.

szFaceName[LF_FACESIZE]

형식: TCHAR[LF_FACESIZE]

글꼴 이름을 지정하는 Null로 끝나는 문자 배열입니다.

설명

서식 특성을 해제하려면 dwMask 에서 적절한 값을 설정하지만 dwEffects에서 해당 값을 설정하지 않습니다. 예를 들어 기울임꼴을 끄려면 CFM_ITALIC 설정하지만 CFE_ITALIC 설정하지 않습니다.

참고

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

요구 사항

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

추가 정보

CHARFORMAT2

EM_GETCHARFORMAT

EM_SETCHARFORMAT

EN_PROTECTED

참조