CDC::GetGlyphOutline

Artigo
08/25/2010

Recupera a estrutura de tópicos curva ou de bitmap para um caractere de estrutura de tópicos na fonte corrente.

DWORD GetGlyphOutline(
   UINT nChar,
   UINT nFormat,
   LPGLYPHMETRICS lpgm,
   DWORD cbBuffer,
   LPVOID lpBuffer,
   const MAT2* lpmat2
) const;

Parâmetros

nChar
Especifica o caractere para os quais informações estão a ser retornado.

nFormat
Especifica o formato no qual a função é para retornar informações.Pode ser um dos seguintes valores ou 0:

Valor	Significado
GGO_BITMAP	Retorna o bitmap de glifo.Quando a função retorna, o buffer apontada por lpBuffer contém um bitmap de 1 bit por pixel cujas linhas iniciar em limites doubleword.
GGO_NATIVE	Retorna a curva de pontos de dados em formato nativo do rasterizador, usando unidades de dispositivo.Quando esse valor for especificado, qualquer transformação especificado em lpmat2 é ignorado.

Quando o valor de nFormat é 0, a função preenche um GLYPHMETRICS estrutura, mas não retorna dados da estrutura de tópicos do glifo.

lpgm
Aponta para um GLYPHMETRICS estrutura que descreve o posicionamento do glifo na célula do caractere.
cbBuffer
Especifica o dimensionar do buffer no qual a função copia informações sobre o caractere de estrutura de tópicos.Se esse valor for 0 e o nFormat parâmetro é o GGO_BITMAP or GGO_NATIVE valores, a função retorna o dimensionar do buffer necessário.
lpBuffer
Aponta para um buffer no qual a função copia informações sobre o caractere de estrutura de tópicos.If nFormat Especifica o GGO_NATIVE valor, as informações é copiado na forma de TTPOLYGONHEADER and TTPOLYCURVE estruturas.Se esse valor for NULO and nFormat é o GGO_BITMAP or GGO_NATIVE valor, a função retorna o dimensionar do buffer necessário.
lpmat2
Aponta para um MAT2 estrutura que contém uma matriz de transformação de caractere.Este parâmetro não pode ser NULO, mesmo quando o GGO_NATIVE valor for especificado para nFormat.

Valor de retorno

O dimensionar, em bytes, do buffer necessário para obter as informações recuperadas se cbBuffer é 0 ou lpBuffer é NULO.Caso contrário, é um valor positivo se a função for bem-sucedida ou – 1 se não houver um erro.

Comentários

Um aplicativo pode girar caracteres recuperados no formato de bitmap, especificando uma matriz de transformação de 2 por 2 na estrutura apontada por lpmat2.

Um estrutura de tópicos do glifo é retornado sistema autônomo uma série de delimitações.Cada contorno é definido por um TTPOLYGONHEADER estrutura seguida por tantas TTPOLYCURVE estruturas conforme o necessário para descrevê-lo.Todos sistema autônomo pontos são retornados sistema autônomo POINTFX estruturas e representam posições absolutas, move não relativa.Aponte fornecida pelo inicialpfxStart membro do TTPOLYGONHEADER estrutura é o ponto em que a estrutura de tópicos para uma delimitação começa.The TTPOLYCURVE estruturas que seguem podem ser polilinha registros ou registros de spline.Polyline registros são uma série de pontos; as linhas desenhadas entre os pontos de descrevem o estrutura de tópicos de caractere.Registros de spline representam as curvas quadráticas usadas pelo TrueType (isto é, quadráticas de b-splines).