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
0	A fonte tem permissão de leitura/gravação.
1	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

Addfontresource

Enumfontfamilies

Enumfonts

Funções de fonte e texto

Visão geral de fontes e texto