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 em 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 ser um dos valores a seguir.

[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 de retorno

Se a função for bem-sucedida, o valor retornado não será zero.

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

Se lpszFontRes especificar um arquivo de fonte existente, GetLastError retornará ERROR_FILE_EXISTS

Observações

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 System 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 tenha sido copiado para o diretório System (ou para o diretório principal do Windows no caso de uma instalação de rede). O arquivo .ttf não precisa estar nesse diretório quando a função CreateScalableFontResource é chamada, pois o parâmetro lpszCurrentPath contém as informações do 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.

Requisitos

Consulte também

AddFontResource

EnumFontFamilies

EnumFonts

Funções de fonte e texto

fontes e visão geral de texto