Partilhar via


CDC::GetFontData

Recupera informações de métrica de fonte 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 retornado.Esse parâmetro pode ser uma das tabelas métricas documentadas na especificação do arquivos de fonte TrueType publicada pela Microsoft Corporation.Se este parâmetro for 0, as informações são recuperadas desde o início do arquivo de fonte.

  • dwOffset
    Especifica o offset do início da tabela à qual começar a recuperar informações.Se este parâmetro for 0, as informações são recuperadas desde o início da tabela especificada pelo dwTable parâmetro. Se esse valor for maior que ou igual ao dimensionar da tabela, GetFontData Retorna 0.

  • lpData
    Aponta para um buffer que receberá as informações de fonte.Se esse valor for NULO, a função retorna o dimensionar do buffer necessário para os dados de fontes especificados no dwTable parâmetro.

  • cbData
    Especifica o comprimento em bytes, as informações a serem recuperados.Se este parâmetro for 0, GetFontData Retorna o dimensionar dos dados especificados no dwTable parâmetro.

Valor de retorno

Especifica o número de bytes retornados buffer apontado por lpData Se a função for bem-sucedida; caso contrário, – 1.

Comentários

As informações para recuperar são identificadas, especificando um deslocamento para o arquivo de fonte e o comprimento das informações a retornar.

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

Aplicativos podem determinar se uma fonte pode ser incorporada, verificando o otmfsType membro do OUTLINETEXTMETRIC estrutura.Se bit 1 de otmfsType é conjunto, incorporação de objetos não é permitida para a fonte.Se bit 1 estiver desmarcada, a fonte pode ser incorporada.Se bit 2 é conjunto, a incorporação é somente leitura.

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

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CDC

Gráfico de hierarquia

CDC::GetOutlineTextMetrics

GetFontData

OUTLINETEXTMETRIC

Outros recursos

Membros do CDC