글꼴을 열거하는 방법

아티클
06/12/2023

이 개요에서는 시스템 글꼴 컬렉션의 글꼴을 패밀리 이름으로 열거하는 방법을 보여 줍니다.

이 개요는 다음 부분으로 구성됩니다.

1단계: 시스템 글꼴 컬렉션을 가져옵니다.
2단계: 글꼴 패밀리 수를 가져옵니다.
For 루프를 만듭니다.
결론
예제 코드

1단계: 시스템 글꼴 컬렉션을 가져옵니다.

DirectWrite 팩터리에서 제공하는 GetSystemFontCollection 메서드를 사용하여 모든 시스템 글꼴이 포함된 IDWriteFontCollection을 반환합니다.

IDWriteFontCollection* pFontCollection = NULL;

// Get the system font collection.
if (SUCCEEDED(hr))
{
    hr = pDWriteFactory->GetSystemFontCollection(&pFontCollection);
}

2단계: 글꼴 패밀리 수를 가져옵니다.

다음으로 IDWriteFontCollection::GetFontFamilyCount를 사용하여 글꼴 컬렉션에서 글꼴 패밀리 수를 가져옵니다. 이를 사용하여 컬렉션의 각 글꼴 패밀리를 반복합니다.

UINT32 familyCount = 0;

// Get the number of font families in the collection.
if (SUCCEEDED(hr))
{
    familyCount = pFontCollection->GetFontFamilyCount();
}

For 루프를 만듭니다.

for (UINT32 i = 0; i < familyCount; ++i)

이제 글꼴 컬렉션과 글꼴 수가 있으므로 나머지 단계는 각 글꼴 패밀리를 반복하여 IDWriteFontFamily 개체를 검색하고 쿼리합니다.

3단계: 글꼴 패밀리를 가져옵니다.

IDWriteFontCollection::GetFontFamily를 사용하고 현재 인덱스 i를 전달하여 IDWriteFontFamily 개체를 가져옵니다.

IDWriteFontFamily* pFontFamily = NULL;

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

4단계: 가족 이름을 가져옵니다.

IDWriteFontFamily::GetFamilyNames를 사용하여 글꼴 패밀리 이름을 가져옵니다. IDWriteLocalizedStrings 개체입니다. 글꼴 패밀리에 대한 여러 지역화된 버전의 패밀리 이름을 가질 수 있습니다.

IDWriteLocalizedStrings* pFamilyNames = NULL;

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

5단계: 로캘 이름을 찾습니다.

IDWriteLocalizedStrings::FindLocaleName 메서드를 사용하여 원하는 로캘에서 글꼴 famliy 이름을 가져옵니다. 이 경우 먼저 기본 로캘이 검색되고 요청됩니다. 이 작업이 작동하지 않으면 "en-us" 로캘이 요청됩니다. 지정된 로캘 중 하나를 찾을 수 없는 경우 이 예제에서는 사용 가능한 첫 번째 로캘인 인덱스 0으로 되돌아가기만 하면 됩니다.

UINT32 index = 0;
BOOL exists = false;

wchar_t localeName[LOCALE_NAME_MAX_LENGTH];

if (SUCCEEDED(hr))
{
    // Get the default locale for this user.
    int defaultLocaleSuccess = GetUserDefaultLocaleName(localeName, LOCALE_NAME_MAX_LENGTH);

    // If the default locale is returned, find that locale name, otherwise use "en-us".
    if (defaultLocaleSuccess)
    {
        hr = pFamilyNames->FindLocaleName(localeName, &index, &exists);
    }
    if (SUCCEEDED(hr) && !exists) // if the above find did not find a match, retry with US English
    {
        hr = pFamilyNames->FindLocaleName(L"en-us", &index, &exists);
    }
}

// If the specified locale doesn't exist, select the first on the list.
if (!exists)
    index = 0;

6단계: 패밀리 이름 문자열 길이 및 문자열의 길이를 가져옵니다.

마지막으로 IDWriteLocalizedStrings::GetStringLength를 사용하여 패밀리 이름 문자열의 길이를 가져옵니다. 이 길이를 사용하여 이름을 저장할 수 있을 만큼 큰 문자열을 할당한 다음 IDWriteLocalizedStrings::GetString을 사용하여 글꼴 패밀리 이름을 가져옵니다.

UINT32 length = 0;

// Get the string length.
if (SUCCEEDED(hr))
{
    hr = pFamilyNames->GetStringLength(index, &length);
}

// Allocate a string big enough to hold the name.
wchar_t* name = new (std::nothrow) wchar_t[length+1];
if (name == NULL)
{
    hr = E_OUTOFMEMORY;
}

// Get the family name.
if (SUCCEEDED(hr))
{
    hr = pFamilyNames->GetString(index, name, length+1);
}

결론

로캘에 패밀리 이름 또는 이름이 있으면 사용자가 선택할 수 있도록 이름을 나열하거나 CreateTextFormat에 전달하여 지정된 글꼴 패밀리를 사용하여 텍스트 서식 지정을 시작할 수 있습니다.

코드 예

이 예제의 전체 소스 코드를 보려면 글꼴 열거형 샘플을 참조하세요.

다음을 통해 공유