Função EnumFontFamiliesA (wingdi.h)

Artigo
08/27/2023

A função EnumFontFamilies enumera as fontes em uma família de fontes especificada que estão disponíveis em um dispositivo especificado.

Nota Essa função é fornecida apenas para compatibilidade com versões de 16 bits do Windows. Os aplicativos devem usar a função EnumFontFamiliesEx .

Sintaxe

int EnumFontFamiliesA(
  [in] HDC           hdc,
  [in] LPCSTR        lpLogfont,
  [in] FONTENUMPROCA lpProc,
  [in] LPARAM        lParam
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo do qual enumerar as fontes.

[in] lpLogfont

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome da família das fontes desejadas. Se lpszFamily for NULL, EnumFontFamilies selecionará e enumerará uma fonte de cada família de tipos disponível.

[in] lpProc

Um ponteiro para a função de retorno de chamada definida pelo aplicativo. Para obter informações, consulte EnumFontFamProc.

[in] lParam

Um ponteiro para dados fornecidos pelo aplicativo. Os dados são passados para a função de retorno de chamada junto com as informações da fonte.

Retornar valor

O valor retornado é o último valor retornado pela função de retorno de chamada. Seu significado é específico da implementação.

Comentários

Para cada fonte que tem o nome typeface especificado pelo parâmetro lpszFamily , a função EnumFontFamilies recupera informações sobre essa fonte e a passa para a função apontada pelo parâmetro lpEnumFontFamProc . A função de retorno de chamada definida pelo aplicativo pode processar as informações de fonte conforme desejado. A enumeração continua até que não haja mais fontes ou a função de retorno de chamada retorne zero.

Quando o modo gráfico no contexto do dispositivo é definido como GM_ADVANCED usando a função SetGraphicsMode e o sinalizador DEVICE_FONTTYPE é passado para o parâmetro FontType, essa função retorna uma lista das fontes tipo 1 e OpenType no sistema. Quando o modo gráfico não é definido como GM_ADVANCED, essa função retorna uma lista das fontes tipo 1, OpenType e TrueType no sistema.

As fontes para muitos idiomas do Leste Asiático têm dois nomes de tipo: um nome em inglês e um nome localizado. EnumFonts, EnumFontFamilies e EnumFontFamiliesEx retornarão o nome da face de tipo em inglês se a localidade do sistema não corresponder ao idioma da fonte.

Exemplos

Para obter exemplos, consulte Enumerando as Fontes Instaladas.

Observação

O cabeçalho wingdi.h define EnumFontFamilies como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll