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 uma cadeia de caracteres do processo.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 WORD. Para obter mais informações, consulte GetCharacterPlacement.nMaxExtent
Especifica a extensão máxima (em unidades lógicas) para a qual a cadeia de caracteres é processada. Os caracteres que, se processados, possam exceder essa extensão são ignorados. Cálculos para qualquer ordenação necessária ou matrizes de glifo se aplicarão somente aos caracteres incluídos. Este parâmetro é usado somente se o valor GCP_MAXEXTENT é especificado no parâmetro dwFlags. À medida que a função processa a cadeia de caracteres de entrada, cada caractere e sua extensão são adicionados à saída, extensão, e outras matrizes somente se a extensão total ainda não excedeu o máximo. Assim que o limite atingido, o processo é interrompido.lpResults
Ponteiro para uma estrutura de GCP_Results que receberá os resultados da função.dwFlags
Especifica como processar a cadeia de caracteres para as matrizes necessárias. Este parâmetro pode ser um ou mais dos valores listados na seção dwFlags do tópico GetCharacterPlacement.str
Um ponteiro para um objeto de CString do processo.
Valor de retorno
Se a função tiver êxito, o valor de retorno será a largura e a altura da cadeia de caracteres em unidades lógicas.
Se a função falhar, o valor de retorno será zero.
Comentários
Essa função de membro emula a funcionalidade da função GetCharacterPlacement, como descrito no Windows SDK.
Requisitos
Cabeçalho: afxwin.h