Função CreateFontIndirectA (wingdi.h)
A função CreateFontIndirect cria uma fonte lógica que tem as características especificadas. Posteriormente, a fonte pode ser selecionada 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.
Retornar valor
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.
Comentários
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 da GDI tenta corresponder a fonte lógica com uma fonte física existente. Se não conseguir encontrar uma correspondência exata, ele fornecerá uma alternativa cujas características correspondem ao máximo possível das características solicitadas.
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 LOGFONT , recupere o nome de face 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 face de tipo: um nome em inglês e um nome localizado. CreateFont e CreateFontIndirect assumem o nome da face de tipo localizada somente em uma localidade do sistema que corresponda 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, 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.
O mapeador de fontes para CreateFont, CreateFontIndirect e 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.
Observação
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 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 |