Partilhar via


CDC::GetFontData

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.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CDC Class

Gráfico da hierarquia

CDC::GetOutlineTextMetrics

GetFontData

OUTLINETEXTMETRIC