IFont 인터페이스(ocidl.h)

Windows 글꼴 개체 주위에 래퍼를 제공합니다. COM 글꼴 개체는 IFont 인터페이스를 통해 다양한 읽기/쓰기 속성과 메서드 집합을 지원합니다. 자동화를 통해 글꼴의 속성에 대한 액세스를 제공하기 위해 IDispatch에서 파생된 디스패치 인터페이스 IFontDisp를 통해 동일한 속성 집합(메서드는 지원되지 않음)을 지원합니다. 시스템은 두 인터페이스를 모두 사용하여 글꼴 개체의 표준 구현을 제공합니다.

글꼴 개체는 발신 인터페이스 IPropertyNotifySink 도 지원하므로 클라이언트는 글꼴 속성이 변경되는 시기를 확인할 수 있습니다. 글꼴 개체는 하나 이상의 나가는 인터페이스를 지원하므로 이 목적을 위해 IConnectionPointContainer 및 관련 인터페이스도 구현합니다.

글꼴 개체는 글꼴에 지정된 다른 특성을 준수하는 Windows 글꼴 핸들인 hFont 속성을 제공합니다. 글꼴 개체는 가능하면 이 hFont 개체의 실현을 지연하므로 글꼴에 두 개의 속성을 연속으로 설정해도 중간 글꼴이 실현되지 않습니다. 또한 시스템 구현 글꼴 개체는 최적화로 글꼴 핸들의 캐시를 유지 관리합니다. 동일한 속성이 있는 동일한 프로세스의 두 글꼴 개체는 동일한 글꼴 핸들을 반환합니다. 글꼴 개체는 이 캐시에서 글꼴 핸들을 제거할 수 있습니다. 그러면 hFont 속성을 사용하는 클라이언트에 대한 특별한 고려 사항이 도입됩니다.

또한 글꼴 개체는 IPersistStream을 지원하므로 IStream의 instance 저장하고 로드할 수 있습니다. 글꼴 개체를 내부적으로 사용하는 개체는 일반적으로 개체의 지속성 처리의 일부로 글꼴을 저장하고 로드합니다.

또한 글꼴 개체는 글꼴의 특성이 포함된 속성 집합을 렌더링할 수 있는 IDataObject를 지원하므로 클라이언트는 이러한 속성을 텍스트로 저장할 수 있습니다.

상속

IFont 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IFont 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IFont 인터페이스에는 이러한 메서드가 있습니다.

IFont::AddRefHfont ReleaseHfont가 호출되거나 글꼴 개체 자체가 완전히 해제될 때까지 hFont로 식별된 이전에 실현된 글꼴이 유효한 상태로 유지되어야 한다는 것을 글꼴 개체에 알립니다.
IFont::Clone 중복된 글꼴 개체를 만듭니다.
IFont::get_Bold 글꼴의 현재 Bold 속성을 가져옵니다.
IFont::get_Charset 글꼴에 사용되는 문자 집합을 검색합니다.
IFont::get_hFont 이 글꼴 개체에서 설명하는 글꼴에 대한 핸들을 검색합니다.
IFont::get_Italic 글꼴의 현재 기울임꼴 속성을 가져옵니다.
IFont::get_Name 글꼴 패밀리의 이름을 검색합니다.
IFont::get_Size 글꼴의 점 크기를 검색합니다.
IFont::get_Strikethrough 글꼴의 현재 Strikethrough 속성을 가져옵니다.
IFont::get_Underline 글꼴의 현재 Underline 속성을 가져옵니다.
IFont::get_Weight 글꼴의 현재 Weight 속성을 가져옵니다.
IFont::IsEqual 동등성을 위해 이 글꼴 개체를 다른 글꼴 개체와 비교합니다.
IFont::p ut_Bold 글꼴의 Bold 속성을 설정합니다.
IFont::p ut_Charset 글꼴의 문자 집합을 설정합니다.
IFont::p ut_Italic 글꼴의 기울임꼴 속성을 설정합니다.
IFont::p ut_Name 글꼴 패밀리의 새 이름을 지정합니다.
IFont::p ut_Size 글꼴의 점 크기를 설정합니다.
IFont::p ut_Strikethrough 글꼴의 Strikethrough 속성을 설정합니다.
IFont::p ut_Underline 글꼴의 Underline 속성을 설정합니다.
IFont::p ut_Weight 글꼴의 Weight 속성을 설정합니다.
IFont::QueryTextMetrics 호출자가 할당한 구조체를 글꼴에 대한 정보로 채웁니다.
IFont::ReleaseHfont 이전에 IFont::AddRefHfont를 사용하여 캐시에서 이 글꼴을 잠근 호출자에게 더 이상 잠금이 필요하지 않음을 글꼴 개체에 알릴 수 있습니다.
IFont::SetHdc 논리 매핑 모드를 설명하는 글꼴에 디바이스 컨텍스트를 제공합니다.
IFont::SetRatio 이 글꼴의 배율 인수를 논리 단위와 HIMETRIC 단위 간에 변환합니다.

설명

IFont 인터페이스의 각 속성에는 속성이 읽기 액세스를 지원하는 경우 get_PropertyName 메서드와 속성이 쓰기 액세스를 지원하는 경우 put_PropertyName 메서드가 포함됩니다. 이러한 속성의 대부분은 읽기 및 쓰기 액세스를 모두 지원합니다.

속성	Type	읽기 액세스 방법	쓰기 액세스 방법	설명
이름	BSTR	get_Name	put_Name	글꼴의 얼굴 이름(예: Arial)입니다.
크기	Cy	get_Size	put_Size	소수점 크기를 허용하도록 CY 형식으로 표현되는 글꼴의 점 크기입니다.
굵게	Bool	get_Bold	put_Bold	글꼴이 굵게 표시되어 있는지 여부를 나타냅니다.
기울임꼴	Bool	get_Italic	put_Italic	글꼴이 기울임꼴인지 여부를 나타냅니다.
Underline	Bool	get_Underline	put_Underline	글꼴에 밑줄이 그어지는지 여부를 나타냅니다.
취소선	Bool	get_Strikethrough	put_Strikethrough	글꼴이 취소선인지 여부를 나타냅니다.
가중치	short	get_Weight	put_Weight	글꼴의 굵게입니다.
Charset	short	get_Charset	put_Charset	글꼴에 사용되는 문자 집합(예: ANSI_CHARSET, DEFAULT_CHARSET 또는 SYMBOL_CHARSET)입니다.
hFont	HFONT	get_hFont		렌더링을 위해 디바이스 컨텍스트로 선택할 수 있는 Windows 글꼴 핸들입니다.

 

OLE 구현

시스템은 기본 시스템 글꼴 지원을 기반으로 IFont 인터페이스를 사용하여 글꼴 개체의 표준 구현을 제공합니다. 글꼴 개체는 OleCreateFontIndirect 함수를 통해 만들어집니다. 글꼴 개체는 IFont 인터페이스를 통해 다양한 읽기/쓰기 속성과 메서드 집합을 지원하며, IDispatch에서 파생된 디스패치 인터페이스 IFontDisp을 통해 Automation을 통해 글꼴의 속성에 대한 액세스를 제공하는 동일한 속성 집합을 지원합니다(메서드는 아님). 글꼴 개체의 시스템 구현은 두 인터페이스를 모두 제공합니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	ocidl.h

추가 정보

IFontDisp