Função GetGlyphIndicesA (wingdi.h)

  • Artigo

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
GGI_MARK_NONEXISTING_GLYPHS
 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

Confira também

Funções de fonte e texto

Visão geral de fontes e texto

GetFontUnicodeRanges