Función GetGlyphIndicesA (wingdi.h)
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 |
|---|---|
|
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 |