Função EnumFontsA (wingdi.h)

Artigo
11/20/2024

A função EnumFonts enumera as fontes disponíveis em um dispositivo especificado. Para cada fonte com o nome de tipo especificado, a função EnumFonts recupera informações sobre essa fonte e a passa para a função de retorno de chamada definida pelo aplicativo. Essa função de retorno de chamada 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.

Observação 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 EnumFontsA(
  [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 face de tipo das fontes desejadas. Se lpFaceName for NULL, EnumFonts selecionar aleatoriamente e enumerar uma fonte de cada face de tipo disponível.

[in] lpProc

Um ponteiro para a função definedcallback do aplicativo. Para obter mais informações, consulte EnumFontsProc.

[in] lParam

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

Valor de retorno

O valor retornado é o último valor retornado pela função de retorno de chamada. Seu significado é definido pelo aplicativo.

Observações

Use EnumFontFamiliesEx em vez de EnumFonts. A função EnumFontFamiliesEx difere da função EnumFonts na qual recupera os nomes de estilo associados a uma fonte TrueType. Com EnumFontFamiliesEx, você pode recuperar informações sobre estilos de fonte que não podem ser enumerados usando a função EnumFonts.

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, EnumFontFamiliese EnumFontFamiliesEx retornar o nome da face de tipo em inglês se a localidade do sistema não corresponder ao idioma da fonte.

Nota

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

Requisitos

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

Consulte também

EnumFontFamilies

EnumFontFamiliesEx

EnumFontsProc

Funções de fonte e texto

fontes e visão geral de texto

getDeviceCaps

Compartilhar via