CDC::GetGlyphOutline
Recupera a curva ou o bitmap estrutura de tópicos para um caractere estrutura de tópicos na fonte atual.
DWORD GetGlyphOutline(
UINT nChar,
UINT nFormat,
LPGLYPHMETRICS lpgm,
DWORD cbBuffer,
LPVOID lpBuffer,
const MAT2* lpmat2
) const;
Parâmetros
nChar
Especifica o caractere para que informações devem ser retornada.nFormat
Especifica o formato em que a função é retornar informações. Pode ser um dos seguintes valores, ou: 0Valor
Significado
GGO_BITMAP
Retorna o bitmap de glifos. Quando a função retorna, o buffer apontado por lpBuffer contém um bitmap de bit-por- 1 pixel cujas linhas começa nos limites de palavra composta.
GGO_NATIVE
Retorna os pontos de dados da curva no formato nativo do rasterizador, usando unidades de dispositivo. Quando esse valor é especificado, qualquer transformação especificada em lpmat2 será ignorada.
Quando o valor de nFormat é 0, a função preenche uma estrutura de GLYPHMETRICS mas não retorna dados contorno de glifos.
lpgm
Pontos a estrutura de GLYPHMETRICS que descreve o posicionamento de glifos na célula de caracteres.cbBuffer
Especifica o tamanho do buffer em que a função copia informações sobre o caractere de estrutura. Se esse valor é 0 e o parâmetro de nFormat são valores de GGO_BITMAP ou de GGO_NATIVE , a função retorna o tamanho do buffer necessário.lpBuffer
Aponta para um buffer em que a função copia informações sobre o caractere de estrutura. Se nFormat especifica o valor de GGO_NATIVE , a informação é copiada na forma de estruturas de TTPOLYGONHEADER e de TTPOLYCURVE . Se esse valor é NULO e nFormat é o valor de GGO_BITMAP ou de GGO_NATIVE , a função retorna o tamanho do buffer necessário.lpmat2
Os pontos a MAT2 estrutura que contém uma matriz de transformação para o caractere. Este parâmetro não pode ser NULO, mesmo quando o valor de GGO_NATIVE é especificado para nFormat.
Valor de retorno
O tamanho, em bytes, de buffer necessário para informações recuperadas se cbBuffer é 0 ou lpBuffer é NULO. Caso contrário, é um valor positivo se a função é bem-sucedida, ou – 1 se houver um erro.
Comentários
Um aplicativo pode ativar os caracteres recuperados no formato de bitmap especificando uma matriz de transformação 2 by-2 na estrutura apontada por lpmat2.
Um contorno de glifo é retornado como uma série dos contornos. Cada estrutura é definido por uma estrutura de TTPOLYGONHEADER seguida por tantas estruturas de TTPOLYCURVE como são necessários para descrever. Todos os pontos são retornados como estruturas de POINTFX e representam posições absolutas, move não relacionados. O ponto de partida determinado pelo membro de pfxStart estrutura de TTPOLYGONHEADER é o ponto em que a estrutura para um contorno é iniciado. Estruturas de TTPOLYCURVE que seguem podem ser registros polyline ou registros de spline. Os registros são uma Polyline fx-series de pontos; as linhas desenhadas entre os pontos descrevem o contorno de caracteres. Os registros de spline representam as curvas bézier quadráticas usadas por TrueType (isto é, b- ranhuras quadráticas).
Requisitos
Cabeçalho: afxwin.h