Interface IDWriteLocalizedStrings (dwrite.h)

Representa uma coleção de cadeias de caracteres indexadas pelo nome da localidade.

Herança

A interface IDWriteLocalizedStrings herda da interface IUnknown . IDWriteLocalizedStrings também tem estes tipos de membros:

Métodos

A interface IDWriteLocalizedStrings tem esses métodos.

IDWriteLocalizedStrings::FindLocaleName Obtém o índice baseado em zero do par nome/cadeia de caracteres de localidade com o nome da localidade especificado.
IDWriteLocalizedStrings::GetCount Obtém o número de pares de idioma/cadeia de caracteres.
IDWriteLocalizedStrings::GetLocaleName Copia o nome da localidade com o índice especificado para a matriz especificada. (IDWriteLocalizedStrings.GetLocaleName)
IDWriteLocalizedStrings::GetLocaleNameLength Obtém o comprimento em caracteres (sem incluir o terminador nulo) do nome da localidade com o índice especificado. (IDWriteLocalizedStrings.GetLocaleNameLength)
IDWriteLocalizedStrings::GetString Copia a cadeia de caracteres com o índice especificado para a matriz especificada. (IDWriteLocalizedStrings.GetString)
IDWriteLocalizedStrings::GetStringLength Obtém o comprimento em caracteres (sem incluir o terminador nulo) da cadeia de caracteres com o índice especificado. (IDWriteLocalizedStrings.GetStringLength)

Comentários

O conjunto de cadeias de caracteres representado por um IDWriteLocalizedStrings é indexado por um número UINT32 baseado em zero que é mapeado para uma localidade. O índice numérico para uma localidade específica é recuado usando o método FindLocaleName .

Um uso comum para a interface IDWriteLocalizedStrings é manter uma lista de nomes de família de fontes localizados criados usando o método IDWriteFontFamily::GetFamilyNames . O exemplo a seguir mostra como obter o nome da família para a localidade "en-us".

IDWriteLocalizedStrings* pFamilyNames = NULL;

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

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;

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);
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	dwrite.h