GetTextExtentExPoint

9/8/2008

Essa função recupera o número de caracteres em um seqüência de caracteres especificado que ajustarem um espaço especificado e preenche uma matriz com a extensão de texto para cada um desses caracteres. Uma extensão de texto é a distância entre o início do espaço e um caractere que couber no espaço.

Syntax

BOOL GetTextExtentExPoint(
  HDC hdc, 
  LPCTSTR lpszStr, 
  int cchString, 
  int nMaxExtent, 
  LPINT lpnFit, 
  LPINT alpDx, 
  LPSIZE lpSize
); 

Parameters

• hDC
  [no] Identificador para o contexto dispositivo (DC).

• lpszStr
  [no] Ponteiro longo para o seqüência de caracteres NULL-Terminated para o qual você desejar para recuperar texto extensões.

• cchString
  [no] Número inteiro que especifica o número de caracteres no seqüência de caracteres para o qual o lpszStr parâmetro pontos.

• nMaxExtent
  [no] Número inteiro que especifica a máxima permitida largura, em unidades lógicas, da formatado seqüência de caracteres.

• lpnFit
  [out] Ponteiro longo para um inteiro que recebe uma contagem do número máximo de caracteres que cabem no espaço especificado pelo nMaxExtent parâmetro. Quando o lpnFit parâmetro é NULL, GetTextExtentExPoint Ignora a nMaxExtent parâmetro.

• alpDx
  [out] Ponteiro longo para uma matriz de inteiros que recebe extensões seqüência de caracteres parcial. Cada elemento na matriz retorna a distância em unidades lógicas, entre o início do seqüência de caracteres e um dos caracteres que couber no espaço especificado pelo nMaxExtent parâmetro. Embora essa matriz deve ter pelo menos quantos elementos como caracteres especificados pela cchString parâmetro, a função preenche a matriz com extensões somente para quantos caracteres são fornecidos pelo lpnFit parâmetro. Se alpDx é NULL, a função seqüência de caracteres parcial não calcular larguras.

• lpSize
  [out] Ponteiro longo para uma estrutura SIZE que contém as dimensões do seqüência de caracteres, em unidades lógicas, quando a função retorna. Este valor não pode ser NULL.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Se ambos os o lpnFit e alpDx Os parâmetros são NULL, chamado de GetTextExtentExPoint função é equivalente ao chamado a função GetTextExtentPoint.

Requirements

Header	windows.h
Library	coredll.lib
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also

Reference

GetTextExtentPoint

Other Resources