Compartir a través de

Función GetGlyphIndicesA (wingdi.h)

  • Artículo

La función GetGlyphIndices traduce una cadena en una matriz de índices de glifos. 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

La longitud de la longitud de la cadena a la que apuntalpstr 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.

Valor 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 WORDs (para la función Unicode) convertida.

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

Observaciones

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 ciertos propósitos de bajo nivel (como manipular archivos de fuente), las aplicaciones de nivel superior que desean asignar una cadena a glifos normalmente desean usar las funciones de 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de wingdi.h (incluya Windows.h)
biblioteca de Gdi32.lib
DLL de Gdi32.dll

Consulte también

funciones de fuente y texto de

de información general de fuentes y texto de

GetFontUnicodeRanges