Função GetGlyphIndicesA (wingdi.h)

Artigo
11/20/2024

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 apontado 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 de retorno

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.

Observações

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 desejam usar as funções Uniscribe.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wingdi.h (inclua Windows.h)
biblioteca	Gdi32.lib
de DLL	Gdi32.dll

Consulte também

Funções de fonte e texto

fontes e visão geral de texto

GetFontUnicodeRanges

Compartilhar via