Partilhar via


CDC::GetCharacterPlacement

Recupera vários tipos de informações em uma cadeia de caracteres.

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 cadeia de caracteres para processamento.

  • nCount
    Especifica o comprimento da cadeia de caracteres.Para a versão ANSI, é uma contagem de BYTE e para a função Unicode é uma contagem de PALAVRA .Para obter mais informações, consulte GetCharacterPlacement.

  • nMaxExtent
    Especifica a extensão máximo (em unidades lógicas) que a cadeia de caracteres é processada.Os caracteres que, se processadas, excederiam esta extensão são ignorados.Computações para todas as matrizes necessários de classificação ou de glifo aplicam-se somente aos caracteres inclusos.Esse parâmetro é usado somente se o valor de GCP_MAXEXTENT é especificado no parâmetro de dwFlags .Como a função processa a cadeia de caracteres de entrada, cada caractere e sua extensão são adicionados à saída, a extensão, e outras matrizes somente se a extensão total ainda não excedeu o máximo.O limite atingido é uma vez, processando parará.

  • lpResults
    Ponteiro a estrutura de GCP_RESULTS que receberá os resultados da função.

  • dwFlags
    Especifica como processar a cadeia de caracteres em matrizes necessários.Este parâmetro pode ser um ou mais dos valores listados na seção de dwFlags do tópico de GetCharacterPlacement .

  • str
    Um ponteiro para um objeto de CString ao processo.

Valor de retorno

Se a função for bem sucedida, o valor de retorno é a largura e altura de cadeia de caracteres em unidades lógicas.

Se a função falhar, o valor de retorno é zero.

Comentários

Essa função de membro emula a funcionalidade de função GetCharacterPlacement, como descrito em Windows SDK.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CDC Class

Gráfico de hierarquia

CDC::ExtTextOut

CDC::GetCharABCWidths

CDC::GetTextMetrics