Função EnumFontFamiliesW (wingdi.h)
A função EnumFontFamilies enumera as fontes em uma família de fontes especificada que estão disponíveis em um dispositivo especificado.
Sintaxe
int EnumFontFamiliesW(
[in] HDC hdc,
[in] LPCWSTR lpLogfont,
[in] FONTENUMPROCW 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.
Valor de retorno
O valor retornado é o último valor retornado pela função de retorno de chamada. Seu significado é específico para a implementação.
Observações
Para cada fonte que tem o nome de tipo especificado pelo parâmetro
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 está 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, EnumFontFamiliese EnumFontFamiliesEx retornar 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.
Nota
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. 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 |