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
| 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 |
|