Função DrawTextExPrivWrap

[DrawTextExPrivWrap 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 DrawTextEx diretamente em vez disso.]

Desenha texto formatado no retângulo especificado. Essa função encapsula uma chamada para DrawTextEx.

Sintaxe

int WINAPI DrawTextExPrivWrap(
  _In_    HDC              hdc,
  _Inout_ LPTSTR           lpchText,
  _In_    int              cchText,
  _Inout_ LPRECT           lprc,
  _In_    UINT             dwDTFormat,
  _In_    LPDRAWTEXTPARAMS lpDTParams
);

Parâmetros

hdc [in]

Tipo: HDC

Um identificador para o contexto do dispositivo no qual desenhar.

lpchText [in, out]

Tipo: LPTSTR

Um ponteiro para um buffer que contém o texto a ser desenhado. Se o parâmetro cchText for -1, a cadeia de caracteres deverá ser terminada em nulo.

Se dwDTFormat incluir DT_MODIFYSTRING, a função poderá adicionar até quatro caracteres adicionais a essa cadeia de caracteres. O buffer que contém a cadeia de caracteres deve ser grande o suficiente para acomodar esses caracteres extras.

cchText [in]

Tipo: int

O comprimento da cadeia de caracteres apontada por lpchText. Se cchText for -1, o parâmetro lpchText será considerado um ponteiro para uma cadeia de caracteres terminada em nulo e DrawTextEx calculará a contagem de caracteres automaticamente.

lprc [in, out]

Tipo: LPRECT

Um ponteiro para uma estrutura RECT que contém o retângulo, em coordenadas lógicas, em que o texto deve ser formatado.

dwDTFormat [in]

Tipo: UINT

As opções de formatação. Consulte a documentação de DrawTextEx para obter uma lista completa de opções.

lpDTParams [in]

Tipo: LPDRAWTEXTPARAMS

Um ponteiro para uma estrutura DRAWTEXTPARAMS que especifica opções de formatação adicionais. Este parâmetro pode ser NULL.

Valor retornado

Tipo: int

Se a função for bem-sucedida, o valor retornado será a altura do texto em unidades lógicas. Se DT_VCENTER ou DT_BOTTOM for especificado, o valor retornado será o deslocamento do membro superior do lprc para a parte inferior do texto desenhado.

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

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

Comentários

DrawTextExPrivWrap 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 416 de ComCtl32.dll para obter um ponteiro de função.

Para comentários adicionais, consulte DrawTextEx.

Requisitos