DWORD GetGlyphOutline ( UINT nChar, UINT nFormat, LPGLYPHMETRICS lpgm, DWORD cbBuffer, LPVOID lpBuffer, const MAT2 FAR * lpmat2 ) const;
Valor de retorno
O tamanho, em bytes, do buffer necessário para 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 ocorrer um erro.
Parâmetros
nChar
Especifica o caractere para que informações é a ser retornado.
nFormat
Especifica o formato em que a função deve retornar informações. Ele pode ser um dos seguintes valores, ou 0:
| Valor | Significado |
| GGO_BITMAP | Retorna o bitmap de glifo. Quando a função retorna, a reserva apontado pelo lpBuffer contém um bitmap de 1 bit por pixel cujas linhas começar em limites de doubleword. |
| GGO_NATIVE | Retorna a curva pontos de dados em formato nativo do conversor de bitmap, usando unidades de dispositivo. Quando esse valor for especificado, qualquer transformação especificada em lpmat2 é ignorada. |
Quando o valor de nFormat for 0, a função preenche uma GLYPHMETRICS estrutura, mas não retorna dados de glifo-contorno.
lpgm
Aponta para uma estrutura GLYPHMETRICS que descreve o posicionamento do glifo na célula de caractere.
cbBuffer
Especifica o tamanho 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 parâmetro nFormat for o GGO_BITMAP ou GGO_NATIVE valores, a função retorna o exigido tamanho do buffer.
lpBuffer
Aponta para um buffer no qual a função copia informações sobre o caractere de estrutura de tópicos. Se nFormat especifica o valor GGO_NATIVE , as informações são copiadas na forma de estruturas TTPOLYGONHEADER e TTPOLYCURVE . Se esse valor é NULL e nFormat é valor o GGO_BITMAP ou GGO_NATIVE , a função retorna o exigido tamanho do buffer.
lpmat2
Aponta para um MAT2 estrutura que contém uma matriz de transformação para o caráter. Este parâmetro não pode ser Nulo, mesmo quando o valor GGO_NATIVE é especificado por nFormat.
Observações
Recupera a curva de estrutura de tópicos ou bitmap para um caractere de estrutura de tópicos na fonte atual.
Um aplicativo pode girar caracteres recuperados no formato de bitmap especificando uma matriz de transformação de 2 por 2 na estrutura apontada pelo lpmat2.
Um contorno de glifo é retornado como uma série de contornos. Cada curva de nível é definida por um TTPOLYGONHEADER estrutura seguido por quantas estruturas TTPOLYCURVE necessárias para descrevê-lo. Todos os pontos são retornados como POINTFX estruturas e representam posições absolutas, movimentos não relativas. O ponto de partida dado pelo membro pfxStart do estrutura TTPOLYGONHEADER é o ponto em que começa o contorno de um contorno. O TTPOLYCURVE estruturas que se seguem podem ser registros de polilinha ou registros de spline. Polyline registros são uma série de pontos; linhas desenhadas entre os pontos descrevem o contorno do personagem. Registros de spline representam quadrático curvas usadas por TrueType (isto é, quadráticos b-splines).
Visão geral do CDC | Membros de classe | Gráfico de hierarquia
Consulte tambémnbsp;CDC::GetOutlineTextMetrics, :: GetGlyphOutline, GLYPHMETRICS, TTPOLYGONHEADER, TTPOLYCURVE