CDC::GetFontData

Artículo
02/19/2013

Recupera información de medida de un archivo de fuente escalable.

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

Parámetros

dwTable
Especifica el nombre de la tabla métricas que se devolverá.Este parámetro puede ser una de las tablas métricas documentadas en la especificación de archivos de fuentes TrueType publicada por Microsoft Corporation.Si este parámetro es 0, la información es el iniciar recuperado al principio del archivo de fuente.
dwOffset
Especifica el desplazamiento desde el inicio de la tabla en la que iniciar la recuperación de información.Si este parámetro es 0, la información es el iniciar recuperado al principio de la tabla especificada por el parámetro de dwTable .Si es este valor mayor o igual que el tamaño de la tabla, GetFontData devuelve 0.
lpData
Señala a un búfer que recibirá información de fuentes.Si este valor es NULL, la función devuelve el tamaño de búfer necesario para los datos de la fuente especificados en el parámetro de dwTable .
cbData
Especifica la longitud, en bytes, de la información que se va a recuperar.Si este parámetro es 0, GetFontData devuelve el tamaño de los datos especificados en el parámetro de dwTable .

Valor devuelto

Especifica el número de bytes devueltos en el búfer indicada por lpData si la función es correcta; si no – 1.

Comentarios

Información a recuperar se identifica especificando un desplazamiento en el archivo de fuente y la longitud de la información para devolver.

Una aplicación puede utilizar a veces la función miembro de GetFontData para guardar una fuente TrueType a un documento.Para ello, la aplicación determina si la fuente se puede incrustar y después recupera el archivo de fuente completo, especificando 0 para dwTable, dwOffset, y los parámetros de cbData .

Las aplicaciones pueden determinar si una fuente puede incrustar comprobando el miembro de otmfsType de la estructura de OUTLINETEXTMETRIC .Si el bit 1 de otmfsType se establece, la inserción no se permite la fuente.Si el bit 1 está claro, la fuente se puede incrustar.Si se establece el bit 2, la incrustación es de sólo lectura.

Si una aplicación intenta utilizar esta función para recuperar información de una fuente de no-TrueType, la función miembro de GetFontData devuelve – 1.