Función GetGlyphIndicesA (wingdi.h)

  • Artículo

La función GetGlyphIndices traduce una cadena en una matriz de índices de glifo. La función se puede usar para determinar si existe un glifo en una fuente.

Sintaxis

DWORD GetGlyphIndicesA(
  [in]  HDC    hdc,
  [in]  LPCSTR lpstr,
  [in]  int    c,
  [out] LPWORD pgi,
  [in]  DWORD  fl
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] lpstr

Puntero a la cadena que se va a convertir.

[in] c

Longitud de la longitud de la cadena a la que apunta lpstr y el tamaño (en WORD) del búfer al que apunta pgi.

[out] pgi

Este búfer debe ser de dimensión c. Si la devolución es correcta, contiene una matriz de índices de glifo correspondientes a los caracteres de la cadena.

[in] fl

Especifica cómo se deben controlar los glifos si no se admiten. Este parámetro puede ser el siguiente valor.

Value Significado
GGI_MARK_NONEXISTING_GLYPHS
 Marca glifos no admitidos con el valor hexadecimal 0xffff.

Valor devuelto

Si la función se ejecuta correctamente, devuelve el número de bytes (para la función ANSI) o WORD (para la función Unicode) convertida.

Si se produce un error en la función, el valor devuelto es GDI_ERROR.

Comentarios

Esta función intenta identificar una representación de glifo único para cada carácter de la cadena a la que apunta lpstr. Aunque esto es útil para determinados propósitos de bajo nivel (como manipular archivos de fuente), las aplicaciones de nivel superior que quieran asignar una cadena a glifos normalmente desean usar las funciones Uniscribe .

Nota:

El encabezado wingdi.h define GetGlyphIndices como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
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

GetFontUnicodeRanges