DWORD GetFontData ( DWORD dwTable, DWORD dwOffset, LPVOID lpData, DWORD cbData ) const;
Valor de retorno
Especifica o número de bytes retornado no buffer apontado pelo lpData se a função for bem-sucedida; caso contrário – 1.
Parâmetros
dwTable
Especifica o nome da tabela métrica a ser retornado. Este parâmetro pode ser uma das tabelas métricas documentadas na especificação de arquivos de fonte TrueType publicada pela Microsoft Corporation. Se este parâmetro for 0, as informações são recuperadas iniciando no início do arquivo de fonte.
dwOffset
Especifica o deslocamento do início do quadro no qual se começar a recuperar informações. Se este parâmetro for 0, as informações são recuperadas iniciando no início da tabela especificada pelo parâmetro dwTable . Se esse valor for maior ou igual ao tamanho da tabela, GetFontData retornará 0.
lpData
Aponta para um buffer que receberá as informações de fonte. Se esse valor for NULL, a função retorna o tamanho do buffer necessário para os dados de tipo de letra especificados no parâmetro dwTable.
cbData
Especifica o comprimento, em bytes, das informações a serem recuperados. Se este parâmetro for 0, GetFontData retorna o tamanho dos dados especificados no parâmetro dwTable.
Observações
Recupera informações de fonte-métrica de um arquivo de fonte escalonável. As informações para recuperar são identificadas, especificando um deslocamento para o arquivo fonte e o comprimento das informações a retornar.
Um aplicativo pode usar, por vezes, a função de membro GetFontData para salvar uma fonte TrueType com um documento. Para fazer isso, o aplicativo determina se a fonte pode ser incorporada e, em seguida, recupera o arquivo de fonte inteira, especificando 0 para as dwTable, dwOffsete cbData parâmetros.
Aplicativos podem determinar se uma fonte pode ser incorporada, verificando o membro otmfsType a estrutura OUTLINETEXTMETRIC . Se bit 1 de otmfsType for definido, a incorporação não é permitida para a fonte. Se bit 1 é claro, a fonte pode ser incorporada. Se bit 2 estiver definido, a incorporação é somente leitura.
Se um aplicativo tenta usar esta função para recuperar informações de uma fonte não-TrueType, a função de membro GetFontData retornará – 1.
Visão geral do CDC | Membros de classe | Gráfico de hierarquia
Consulte tambémnbsp;CDC::GetOutlineTextMetrics, :: GetFontData, OUTLINETEXTMETRIC