Função GetFontData (wingdi.h)

A função GetFontData recupera dados de métrica de fonte para uma fonte TrueType.

Sintaxe

DWORD GetFontData(
  [in]  HDC   hdc,
  [in]  DWORD dwTable,
  [in]  DWORD dwOffset,
  [out] PVOID pvBuffer,
  [in]  DWORD cjBuffer
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in] dwTable

O nome de uma tabela de métricas de fonte da qual os dados da fonte devem ser recuperados. Esse parâmetro pode identificar uma das tabelas de métricas documentadas na especificação TrueType Font Files publicada pela Microsoft Corporation. Se esse parâmetro for zero, as informações serão recuperadas a partir do início do arquivo para arquivos de fonte TrueType ou do início dos dados para a fonte atualmente selecionada para arquivos da Coleção TrueType. Para recuperar os dados do início do arquivo para arquivos da Coleção TrueType, especifique 'ttcf' (0x66637474).

[in] dwOffset

O deslocamento do início da tabela de métricas de fonte para o local em que a função deve começar a recuperar informações. Se esse parâmetro for zero, as informações serão recuperadas a partir do início da tabela especificada pelo parâmetro dwTable . Se esse valor for maior ou igual ao tamanho da tabela, ocorrerá um erro.

[out] pvBuffer

Um ponteiro para um buffer que recebe as informações da fonte. Se esse parâmetro for NULL, a função retornará o tamanho do buffer necessário para os dados da fonte.

[in] cjBuffer

O comprimento, em bytes, das informações a serem recuperadas. Se esse parâmetro for zero, GetFontData retornará o tamanho dos dados especificados no parâmetro dwTable .

Retornar valor

Se a função for bem-sucedida, o valor retornado será o número de bytes retornados.

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

Comentários

Essa função destina-se a ser usada para recuperar informações de fonte TrueType diretamente do arquivo de fonte por aplicativos de manipulação de fonte. Para obter informações sobre como inserir fontes, consulte a Referência de inserção de fontes.

Às vezes, um aplicativo pode usar a função GetFontData para salvar uma fonte TrueType com um documento. Para fazer isso, o aplicativo determina se a fonte pode ser inserida verificando o membro otmfsType da estrutura OUTLINETEXTMETRIC . Se o bit 1 de otmfsType estiver definido, a inserção não será permitida para a fonte. Se o bit 1 estiver claro, a fonte poderá ser inserida. Se o bit 2 estiver definido, a inserção será somente leitura. Se a inserção for permitida, o aplicativo poderá recuperar todo o arquivo de fonte, especificando zero para os parâmetros dwTable, dwOffset e cbData .

Se um aplicativo tentar usar essa função para recuperar informações de uma fonte não TrueType, ocorrerá um erro.

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

Confira também

Funções de fonte e texto

Visão geral de fontes e texto

Gettextmetrics

OUTLINETEXTMETRIC