Función GetFontData (wingdi.h)
La función GetFontData recupera los datos de métricas de fuente de una fuente TrueType.
Sintaxis
DWORD GetFontData(
[in] HDC hdc,
[in] DWORD dwTable,
[in] DWORD dwOffset,
[out] PVOID pvBuffer,
[in] DWORD cjBuffer
);
Parámetros
[in] hdc
Identificador del contexto del dispositivo.
[in] dwTable
Nombre de una tabla de métricas de fuente a partir de la cual se van a recuperar los datos de fuente. Este parámetro puede identificar una de las tablas de métricas documentadas en la especificación TrueType Font Files publicada por Microsoft Corporation. Si este parámetro es cero, la información se recupera a partir del principio del archivo para los archivos de fuente TrueType o desde el principio de los datos de la fuente seleccionada actualmente para los archivos de colección TrueType. Para recuperar los datos desde el principio del archivo para los archivos de colección TrueType, especifique "ttcf" (0x66637474).
[in] dwOffset
Desplazamiento desde el principio de la tabla de métricas de fuente hasta la ubicación donde la función debe empezar a recuperar información. Si este parámetro es cero, la información se recupera a partir del principio de la tabla especificada por el parámetro dwTable . Si este valor es mayor o igual que el tamaño de la tabla, se produce un error.
[out] pvBuffer
Puntero a un búfer que recibe la información de fuente. Si este parámetro es NULL, la función devuelve el tamaño del búfer necesario para los datos de fuente.
[in] cjBuffer
Longitud, en bytes, de la información que se va a recuperar. Si este parámetro es cero, GetFontData devuelve el tamaño de los datos especificados en el parámetro dwTable .
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es el número de bytes devueltos.
Si se produce un error en la función, el valor devuelto es GDI_ERROR.
Comentarios
Esta función está pensada para usarse para recuperar información de fuente TrueType directamente desde el archivo de fuente mediante aplicaciones de manipulación de fuentes. Para obtener información sobre la inserción de fuentes, vea la Referencia de inserción de fuentes.
A veces, una aplicación puede usar la función GetFontData para guardar una fuente TrueType con un documento. Para ello, la aplicación determina si la fuente se puede incrustar comprobando el miembro otmfsType de la estructura OUTLINETEXTMETRIC . Si se establece el bit 1 de otmfsType , no se permite insertar para la fuente. Si el bit 1 está desactivado, la fuente se puede insertar. Si se establece el bit 2, la inserción es de solo lectura. Si se permite la inserción, la aplicación puede recuperar todo el archivo de fuente, especificando cero para los parámetros dwTable, dwOffset y cbData .
Si una aplicación intenta usar esta función para recuperar información de una fuente que no es TrueType, se produce un error.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | wingdi.h (incluye Windows.h) |
| Library | Gdi32.lib |
| Archivo DLL | Gdi32.dll |