Função CreateFontIndirectA (wingdi.h)

Artigo
11/20/2024

A função CreateFontIndirect cria uma fonte lógica que tem as características especificadas. A fonte pode ser selecionada posteriormente como a fonte atual para qualquer contexto de dispositivo.

Sintaxe

HFONT CreateFontIndirectA(
  [in] const LOGFONTA *lplf
);

Parâmetros

[in] lplf

Um ponteiro para uma estrutura LOGFONT que define as características da fonte lógica.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será um identificador para uma fonte lógica.

Se a função falhar, o valor retornado será NULL.

Observações

A função CreateFontIndirect cria uma fonte lógica com as características especificadas na estrutura LOGFONT. Quando essa fonte é selecionada usando a função SelectObject, o mapeador de fontes do GDI tenta corresponder a fonte lógica com uma fonte física existente. Se ele não encontrar uma correspondência exata, ele fornecerá uma alternativa cujas características correspondem ao máximo de características solicitadas possível.

Para obter a fonte apropriada em diferentes versões de idioma do sistema operacional, chame EnumFontFamiliesEx com as características de fonte desejadas na estrutura de LOGFONT, recupere o nome de tipo apropriado e crie a fonte usando CreateFont ou CreateFontIndirect.

Quando você não precisar mais da fonte, chame a função DeleteObject para excluí-la.

As fontes para muitos idiomas do Leste Asiático têm dois nomes de tipo: um nome em inglês e um nome localizado. CreateFont e CreateFontIndirect assumem o nome de tipo localizado apenas em uma localidade do sistema que corresponde ao idioma, enquanto eles tomam o nome da face de tipo em inglês em todas as outras localidades do sistema. O melhor método é tentar um nome e, em caso de falha, tentar o outro. Observe que 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.

O mapeador de fontes para CreateFont, CreateFontIndirecte CreateFontIndirectEx reconhece o nome da face de tipo em inglês e localizado, independentemente da localidade.

Exemplos

Para obter um exemplo, consulte Criando uma fonte lógica.

Nota

O cabeçalho wingdi.h define CreateFontIndirect 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