EM_SETCHARFORMAT 메시지

서식 있는 편집 컨트롤에서 문자 서식을 설정합니다.

매개 변수

wParam

컨트롤에 적용되는 문자 서식입니다. 이 매개 변수가 0이면 기본 문자 형식이 설정됩니다. 그렇지 않으면 다음 값 중 하나일 수 있습니다.

값	의미
SCF_ALL	컨트롤의 모든 텍스트에 서식을 적용합니다. SCF_SELECTION 또는 SCF_WORD에는 유효하지 않습니다.
SCF_ASSOCIATEFONT	RichEdit 4.1: 지정된 스크립트에 글꼴을 연결하여 해당 스크립트의 기본 글꼴을 변경합니다. 글꼴을 지정하려면 CHARFORMAT2의 다음 멤버를 사용합니다. yHeight, bCharSet, bPitchAndFamily, szFaceName 및 lcid.
SCF_ASSOCIATEFONT2	RichEdit 4.1: 서로게이트(plane-2) 글꼴을 지정된 스크립트에 연결하여 해당 스크립트의 기본 글꼴을 변경합니다. 글꼴을 지정하려면 CHARFORMAT2의 다음 멤버를 사용합니다. yHeight, bCharSet, bPitchAndFamily, szFaceName 및 lcid.
SCF_CHARREPFROMLCID	LCID에서 캐릭터 레퍼토리를 가져옵니다.
SCF_DEFAULT	RichEdit 4.1: 컨트롤의 기본 글꼴을 설정합니다.
SPF_DONTSETDEFAULT	서식 있는 편집 컨트롤이 비어 있을 때 기본 단락 서식 설정을 방지합니다.
SCF_NOKBUPDATE	RichEdit 4.1: 글꼴과 일치하도록 키보드 전환을 방지합니다. 예를 들어, 아랍어 글꼴이 설정된 경우 일반적으로 Bidi 언어의 자동 키보드 기능은 키보드를 아랍어 키보드로 변경합니다.
SCF_SELECTION	현재 선택 항목에 서식을 적용합니다. 선택 항목이 비어 있으면 삽입 지점에 문자 서식이 적용되고 삽입 지점이 변경될 때까지만 새 문자 서식이 적용됩니다.
SPF_SETDEFAULT	기본 단락 서식 특성을 설정합니다.
SCF_SMARTFONT	스크립트를 처리할 수 있는 경우에만 글꼴을 적용합니다.
SCF_USEUIRULES	RichEdit 4.1:SCF_SELECTION과 함께 사용됩니다. 형식이 도구 모음 또는 기타 UI 도구에서 제공되었음 나타내므로 리터럴 형식 지정 대신 UI 형식 지정 규칙을 사용해야 합니다.
SCF_WORD	선택한 단어에 서식을 적용합니다. 선택 항목이 비어 있지만 삽입 지점이 단어 안에 있으면 해당 단어에 서식이 적용됩니다. SCF_WORD 값은 SCF_SELECTION 값과 함께 사용해야 합니다.

lParam

사용할 문자 서식을 지정하는 CHARFORMAT 구조체에 대한 포인터입니다. dwMask 멤버가 지정한 서식 특성만 변경됩니다.

Microsoft Rich Edit 2.0 이상: 이 매개 변수는 CHARFORMAT 구조체의 확장인 CHARFORMAT2 구조체에 대한 포인터일 수 있습니다. EM_SETCHARFORMAT 메시지를 보내기 전에 구조체의 cbSize 멤버를 sizeof(CHARFORMAT) 또는 sizeof(CHARFORMAT2)로 설정하여 사용 중인 구조체의 버전을 나타냅니다.

szFaceName 및 bCharSet 멤버는 문자에 대해 유효하지 않은 경우 무효화될 수 있습니다(예: kanji 문자의 Arial).

반환 값

작업이 성공하면 반환 값은 0이 아닌 값입니다.

작업이 실패하면 반환 값은 0입니다.

설명

이 메시지가 동일한 매개 변수로 두 번 이상 전송되면 텍스트에 대한 효과가 토글됩니다. 즉, 메시지를 한 번 보내면 효과가 발생하고 메시지를 두 번 보내면 효과가 취소되는 식입니다.

요구 사항

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

추가 정보

참조

CHARFORMAT

CHARFORMAT2