ITextRange::SetFont 메서드(tom.h)

아티클
03/06/2024

이 범위의 문자 특성을 지정된 ITextFont 개체의 특성으로 설정합니다.

구문

HRESULT SetFont(
  [in] ITextFont *pFont
);

매개 변수

[in] pFont

형식: ITextFont*

원하는 문자 형식의 글꼴 개체입니다.

반환 값

형식: HRESULT

메서드는 HRESULT 값을 반환합니다. 메서드가 성공하면 S_OK 반환합니다. 메서드가 실패하면 다음 오류 코드 중 하나를 반환합니다. COM 오류 코드에 대한 자세한 내용은 COM에서 오류 처리를 참조하세요.

반환 코드	설명
값	의미
E_ACCESSDENIED	텍스트가 보호됩니다.
E_INVALIDARG	pFont 가 null입니다.
E_OUTOFMEMORY	메모리가 부족합니다.

설명

가끔 형식을 변경하려면 ITextRange::SetFont 메서드를 사용합니다. 그러나 문자 서식을 여러 개 변경하려면 글꼴 중복을 사용하는 것이 더 효율적입니다. 이는 과 같은 range.font.bold = tomTrue문을 실행할 때마다 글꼴 개체가 할당되고 해제되므로 발생합니다. 그러나 글꼴 중복을 한 번 할당하고 여러 번 사용할 수 있습니다. 또한 글꼴 중복을 저장하고 Reset 메서드를 사용하여 기본 또는 정의되지 않은 상태로 다시 설정한 다음 서식 있는 텍스트 처리에 필요한 값을 제공할 수 있습니다. 글꼴 중복을 사용하는 방법을 보여 주는 샘플 코드는 글 꼴 중복 사용을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	tom.h
DLL	Msftedit.dll