DrawTextWrap 函数

[DrawTextWrap 可通过 Service Pack 2 (SP2) 的 Windows XP 获得。 后续版本中可能会更改或不可用。 建议直接使用 DrawText 。]

绘制指定矩形中的格式化文本。 它根据指定的方法设置文本格式, (展开制表符、对齐字符、断行等) 。 此函数包装对 DrawText 的调用。

语法

int WINAPI DrawTextWrap(
  _In_    HDC              hdc,
  _Inout_ LPCTSTR          lpString,
  _In_    int              nCount,
  _Inout_ LPRECT           lpRect,
  _In_    UINT             uFormat,
  _In_    LPDRAWTEXTPARAMS lpDTParams
);

参数

hdc [in]

类型: HDC

设备上下文的句柄。

lpString [in, out]

类型: LPCTSTR

指向包含要绘制的文本的缓冲区的指针。 如果 nCount 参数为 -1,则字符串必须以 null 结尾。

如果 uFormat 包含DT_MODIFYSTRING,则此函数最多可以为此字符串添加四个字符。 包含字符串的缓冲区应足够大,以适应这些额外字符。

nCount [in]

类型: int

由 lpString 指向的字符串的长度。 如果 nCount 为 -1,则假定 lpString 参数是指向 null 终止字符串的指针, DrawText 会自动计算字符计数。

lpRect [in, out]

类型: LPRECT

指向 RECT 结构的指针,该结构包含要设置文本格式的矩形的逻辑坐标。

uFormat [in]

类型: UINT

格式设置选项。 有关选项的完整列表,请参阅 DrawText 的文档。

lpDTParams [in]

类型: LPDRAWTEXTPARAMS

指向 DRAWTEXTPARAMS 结构的指针,该结构指定其他格式设置选项。 此参数可以为 NULL。

返回值

类型: int

如果函数成功,则返回值是逻辑单元中的文本高度。 如果指定了DT_VCENTERDT_BOTTOM,则返回值是从 lprc顶部成员到绘制文本底部的偏移量。如果函数失败,则返回值为零。

如果函数失败,则返回值为零。

要获得更多的错误信息,请调用 GetLastError

备注

DrawTextWrap 不按名称导出或在公共标头中声明。 若要使用它,必须使用 GetProcAddress 并从ComCtl32.dll请求序号 415 以获取函数指针。

有关其他备注,请参阅 DrawText

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
DLL
Comctl32.dll (6.0 或更高版本)