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 |