CDC::GetFontData

Artigo
02/25/2013

Recupera informações fontes métrica de um arquivo de fonte escalonável.

DWORD GetFontData(
   DWORD dwTable,
   DWORD dwOffset,
   LPVOID lpData,
   DWORD cbData 
) const;

Parâmetros

dwTable
Especifica o nome da tabela métrica a ser retornada.Este parâmetro pode ser uma das tabelas métricas documentadas na especificação de arquivos de fontes TrueType de publicado pela Microsoft Corporation.Se esse parâmetro é 0, a informação é recuperado começar no início do arquivo de fonte.
dwOffset
Especifica o deslocamento do início da tabela para iniciar a recuperação de informações.Se esse parâmetro é 0, a informação é recuperado começar no início da tabela especificada pelo parâmetro de dwTable .Se esse valor é maior ou igual ao tamanho da tabela, retorna 0 de GetFontData .
lpData
Aponta para um buffer que recebe informações da fonte.Se esse valor é NULO, a função retorna o tamanho do buffer necessário para os dados da fonte especificado no parâmetro de dwTable .
cbData
Especifica o tamanho, em bytes, de informações a ser recuperada.Se esse parâmetro é 0, GetFontData retorna o tamanho dos dados especificado no parâmetro de dwTable .

Valor de retorno

Especifica o número de bytes retornados em buffer apontado por lpData se a função é com êxito; se não – 1.

Comentários

Informações para recuperar é identificada especificando um deslocamento no arquivo de fonte e o comprimento de informações para retornar.

Um aplicativo as vezes pode usar a função de membro de GetFontData para salvar uma fonte de TrueType com um documento.Para fazer isso, o aplicativo determina se a fonte pode ser incorporada e recupera o arquivo de fonte inteiro, especificando 0 para dwTable, dwOffset, e parâmetros de cbData .

Os aplicativos podem determinar se uma fonte pode ser incorporada verificando o membro de otmfsType estrutura de OUTLINETEXTMETRIC .Se o bit de 1 otmfsType é definido, inserir não é permitido para a fonte.Se o bit 1 é claro, a fonte pode ser incorporada.Se o bit 2 é definida como, a incorporação é somente leitura.

Se um aplicativo tentar usar essa função para recuperar informações de uma fonte de não TrueType, a função de membro de GetFontData retorna – 1.