Função GetGlyphIndicesA (wingdi.h)
A função GetGlyphIndices converte uma cadeia de caracteres em uma matriz de índices de glifo. A função pode ser usada para determinar se existe um glifo em uma fonte.
Sintaxe
DWORD GetGlyphIndicesA(
[in] HDC hdc,
[in] LPCSTR lpstr,
[in] int c,
[out] LPWORD pgi,
[in] DWORD fl
);
Parâmetros
[in] hdc
Um identificador para o contexto do dispositivo.
[in] lpstr
Um ponteiro para a cadeia de caracteres a ser convertida.
[in] c
O comprimento do comprimento da cadeia de caracteres apontada por lpstr e o tamanho (em WORDs) do buffer apontado por pgi.
[out] pgi
Esse buffer deve ser da dimensão c. No retorno bem-sucedido, contém uma matriz de índices de glifo correspondentes aos caracteres na cadeia de caracteres.
[in] fl
Especifica como os glifos devem ser tratados se não tiverem suporte. Esse parâmetro pode ser o valor a seguir.
| Valor | Significado |
|---|---|
|
Marca glifos sem suporte com o valor hexadecimal 0xffff. |
Valor retornado
Se a função for bem-sucedida, ela retornará o número de bytes (para a função ANSI) ou WORDs (para a função Unicode) convertidos.
Se a função falhar, o valor retornado será GDI_ERROR.
Comentários
Essa função tenta identificar uma representação de glifo único para cada caractere na cadeia de caracteres apontada por lpstr. Embora isso seja útil para determinadas finalidades de baixo nível (como manipular arquivos de fonte), aplicativos de nível superior que desejam mapear uma cadeia de caracteres para glifos normalmente desejarão usar as funções Uniscribe .
Observação
O cabeçalho wingdi.h define GetGlyphIndices como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | wingdi.h (inclua Windows.h) |
| Biblioteca | Gdi32.lib |
| DLL | Gdi32.dll |