Partilhar via


CDC::GetCharacterPlacement

Recupera vários tipos de informações sobre como uma seqüência de caractere.

DWORD GetCharacterPlacement(
   LPCTSTR lpString,
   int nCount,
   int nMaxExtent,
   LPGCP_RESULTS lpResults,
   DWORD dwFlags
) const;
DWORD GetCharacterPlacement(
   CString& str,
   int nMaxExtent,
   LPGCP_RESULTS lpResults,
   DWORD dwFlags
) const;

Parâmetros

  • lpString
    Um ponteiro para a seqüência de caractere para processar.

  • nCount
    Especifica o comprimento da seqüência de caracteres.Para a versão ANSI, ele é um BYTE contagem e para a função Unicode é um PALAVRA contagem.Para obter mais informações, consulte GetCharacterPlacement.

  • nMaxExtent
    Especifica o limite máximo (em unidades lógicas) para que a seqüência de caracteres é processada.Caracteres que se processado, excede essa extensão são ignorados.Cálculos para qualquer array de pedidos ou glifo necessário se aplicam apenas aos caracteres incluídos.Este parâmetro é usado somente se o GCP_MAXEXTENT valor é especificado no dwFlags parâmetro. sistema autônomo a função processa a seqüência de caracteres de entrada, cada caractere e a sua extensão é adicionado à saída, extensão e outros arrays somente se a extensão total ainda não tiver ultrapassado o máximo.Quando o limite for atingido, o processamento será interrompida.

  • lpResults
    Ponteiro para um GCP_RESULTS estrutura que recebe os resultados da função.

  • dwFlags
    Especifica como processo a seqüência de caracteres em arrays necessárias.Esse parâmetro pode ser um ou mais dos valores listados no dwFlags seção o GetCharacterPlacement tópico.

  • str
    Um ponteiro para um CString objeto para processar.

Valor de retorno

Se a função obtiver êxito, o valor retornado é a largura e altura da seqüência de caracteres em unidades lógicas.

Se a função falhar, o valor retornado será zero.

Comentários

Esta função de membro emula a funcionalidade da função GetCharacterPlacement, conforme descrito no Windows SDK.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CDC

Gráfico de hierarquia

CDC::ExtTextOut

CDC::GetCharABCWidths

CDC::GetTextMetrics

Outros recursos

Membros do CDC