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

Consulte también

Funciones de fuente y texto

Información general sobre fuentes y texto

GetTextMetrics

OUTLINETEXTMETRIC