Partilhar via


Função GetTextExtentPoint32Wrap

[GetTextExtentPoint32Wrap está disponível por meio do Windows XP com Service Pack 2 (SP2). Ele pode estar alterado ou indisponível em versões subsequentes. É recomendável usar GetTextExtentPoint diretamente em vez disso.]

Calcula a largura e a altura da cadeia de caracteres de texto especificada. Essa função encapsula uma chamada para GetTextExtentPoint.

Sintaxe

BOOL GetTextExtentPoint32Wrap(
  _In_  HDC     hdc,
  _In_  LPCTSTR lpString,
  _In_  UINT    cbCount,
  _Out_ LPSIZE  lpSize
);

Parâmetros

hdc [in]

Tipo: HDC

Um identificador para o contexto do dispositivo.

lpString [in]

Tipo: LPCTSTR

Um ponteiro para um buffer que contém o texto a ser desenhado. A cadeia de caracteres não precisa ser terminada em zero, pois cbCount especifica o comprimento da cadeia de caracteres.

cbCount [in]

Tipo: UINT

O comprimento, em bytes, da cadeia de caracteres apontada por lpString.

lpSize [out]

Tipo: LPSIZE

Quando esse método retorna, contém um ponteiro para uma estrutura SIZE que contém as dimensões da cadeia de caracteres, em unidades lógicas.

Valor retornado

Tipo: BOOL

Retorna um valor diferente de zero se tiver êxito; caso contrário, 0.

Para obter informações de erro estendidas, chame GetLastError.

Comentários

GetTextExtentPoint32Wrap não é exportado por nome ou declarado em um arquivo de cabeçalho público. Para usá-lo, você deve usar GetProcAddress e solicitar o ordinal 420 de ComCtl32.dll para obter um ponteiro de função.

Para comentários adicionais, consulte GetTextExtentPoint.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
DLL
Comctl32.dll (versão 5.81 ou posterior)