Função CreateScalableFontResourceA (wingdi.h)
[A função CreateScalableFontResource está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Pode ser
alterado ou indisponível nas versões subsequentes.]
A função CreateScalableFontResource cria um arquivo de recurso de fonte para uma fonte escalonável.
Sintaxe
BOOL CreateScalableFontResourceA(
[in] DWORD fdwHidden,
[in] LPCSTR lpszFont,
[in] LPCSTR lpszFile,
[in] LPCSTR lpszPath
);
Parâmetros
[in] fdwHidden
Especifica se a fonte é uma fonte somente leitura. Esse parâmetro pode usar um dos valores a seguir.
Valor | Significado |
---|---|
|
A fonte tem permissão de leitura/gravação. |
|
A fonte tem permissão somente leitura e deve ser ocultada de outros aplicativos no sistema. Quando esse sinalizador é definido, a fonte não é enumerada pela função EnumFonts ou EnumFontFamilies . |
[in] lpszFont
Um ponteiro para uma cadeia de caracteres terminada em nulo especificando o nome do arquivo de recurso de fonte a ser criado. Se esse parâmetro especificar um arquivo de recurso de fonte existente, a função falhará.
[in] lpszFile
Um ponteiro para uma cadeia de caracteres terminada em nulo especificando o nome do arquivo de fonte escalonável que essa função usa para criar o arquivo de recurso de fonte.
[in] lpszPath
Um ponteiro para uma cadeia de caracteres terminada em nulo especificando o caminho para o arquivo de fonte escalonável.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero.
Se lpszFontRes especificar um arquivo de fonte existente, GetLastError retornará ERROR_FILE_EXISTS
Comentários
A função CreateScalableFontResource é usada por aplicativos que instalam fontes TrueType. Um aplicativo usa a função CreateScalableFontResource para criar um arquivo de recurso de fonte (normalmente com uma extensão de nome de arquivo .fot) e usa a função AddFontResource para instalar a fonte. O arquivo de fonte TrueType (normalmente com uma extensão de nome de arquivo .ttf) deve estar no subdiretório Sistema do diretório do Windows a ser usado pela função AddFontResource .
A função CreateScalableFontResource atualmente dá suporte apenas a fontes escalonáveis da tecnologia TrueType.
Quando o parâmetro lpszFontFile especifica apenas um nome de arquivo e uma extensão, o parâmetro lpszCurrentPath deve especificar um caminho. Quando o parâmetro lpszFontFile especifica um caminho completo, o parâmetro lpszCurrentPath deve ser NULL ou um ponteiro para NULL.
Quando apenas um nome de arquivo e uma extensão são especificados no parâmetro lpszFontFile e um caminho é especificado no parâmetro lpszCurrentPath , a cadeia de caracteres em lpszFontFile é copiada para o arquivo .fot como o arquivo .ttf que pertence a esse recurso. Quando a função AddFontResource é chamada, o sistema operacional pressupõe que o arquivo .ttf foi copiado para o diretório System (ou para o diretório main Windows no caso de uma instalação de rede). O arquivo .ttf não precisa estar nesse diretório quando a função CreateScalableFontResource for chamada, pois o parâmetro lpszCurrentPath contém as informações de diretório. Um recurso criado dessa maneira não contém informações absolutas de caminho e pode ser usado em qualquer instalação.
Quando um caminho é especificado no parâmetro lpszFontFile e NULL é especificado no parâmetro lpszCurrentPath , a cadeia de caracteres em lpszFontFile é copiada para o arquivo .fot. Nesse caso, quando a função AddFontResource é chamada, o arquivo .ttf deve estar no local especificado no parâmetro lpszFontFile quando a função CreateScalableFontResource foi chamada; o parâmetro lpszCurrentPath não é necessário. Um recurso criado dessa maneira contém referências absolutas a caminhos e unidades e não funciona se o arquivo .ttf for movido para um local diferente.
Observação
O cabeçalho wingdi.h define CreateScalableFontResource 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
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 |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de