IDWriteFontFamily 인터페이스(dwrite.h)

관련 글꼴 패밀리를 나타냅니다.

상속

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

메서드

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

IDWriteFontFamily::GetFamilyNames 로캘 이름으로 인덱싱된 글꼴 패밀리의 패밀리 이름을 포함하는 지역화된 문자열 개체를 만듭니다. (IDWriteFontFamily.GetFamilyNames)
IDWriteFontFamily::GetFirstMatchingFont 지정된 속성과 가장 일치하는 글꼴을 가져옵니다.
IDWriteFontFamily::GetMatchingFonts 지정된 속성과 얼마나 일치하는지 순서대로 순위가 지정된 글꼴 패밀리의 글꼴 목록을 가져옵니다.

설명

글꼴 패밀리는 "Times New Roman"과 같은 동일한 패밀리 이름을 공유하지만 기능이 다른 글꼴 집합입니다. 이러한 기능 차이에는 기울임꼴과 같은 스타일과 굵게와 같은 가중치가 포함됩니다.

다음 그림에서는 "Times New Roman" 글꼴 패밀리의 멤버인 글꼴의 예를 보여 줍니다.

다음 예제에 표시된 IDWriteFontCollection::GetFontFamily 메서드를 사용하여 글꼴 컬렉션에서 IDWriteFontFamily 개체를 검색할 수 있습니다. GetFontFamily 는 UINT32 인덱스 및 해당 인덱스에서 글꼴의 글꼴 패밀리를 반환합니다.

IDWriteFontFamily* pFontFamily = NULL;

// Get the font family.
if (SUCCEEDED(hr))
{
    hr = pFontCollection->GetFontFamily(i, &pFontFamily);
}

글꼴 패밀리 이름은 텍스트 레이아웃 및 텍스트 서식 개체의 글꼴 패밀리를 지정하는 데 사용됩니다. 다음 코드와 같이 IDWriteFontFamily::GetFamilyNames 메서드를 사용하여 IDWriteFontFamily 개체의 형식으로 IDWriteFontFamily 개체에서 지역화된 글꼴 패밀리 이름 목록을 가져올 수 있습니다.

IDWriteLocalizedStrings* pFamilyNames = NULL;

// Get a list of localized strings for the family name.
if (SUCCEEDED(hr))
{
    hr = pFontFamily->GetFamilyNames(&pFamilyNames);
}

요구 사항

지원되는 최소 클라이언트	Windows 7, Windows Vista SP2 및 Windows Vista용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2, Windows Server 2008 SP2 및 Windows Server 2008용 플랫폼 업데이트 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	dwrite.h

추가 정보

IDWriteFontList