setTextJustification 函数 (wingdi.h)

SetTextJustification 函数指定系统应向文本字符串中的断字符添加的空间量。 当应用程序调用 TextOutExtTextOut 函数时,将添加空间。

语法

BOOL SetTextJustification(
  [in] HDC hdc,
  [in] int extra,
  [in] int count
);

参数

[in] hdc

设备上下文的句柄。

[in] extra

要添加到文本行的总额外空间(以逻辑单元为单位)。 如果未MM_TEXT当前映射模式,则 由 nBreakExtra 参数标识的值将转换并舍入为最近的像素。

[in] count

行中的断字符数。

返回值

如果该函数成功,则返回值为非零值。

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

注解

分隔符通常是 ASCII 32) (空格字符,但它可能由字体定义为其他字符。 GetTextMetrics 函数可用于检索字体的断字符。

TextOut 函数在行中的分隔符之间均匀分配指定的额外空间。

GetTextExtentPoint32 函数始终与 SetTextJustification 函数一起使用。 有时 ,GetTextExtentPoint32 函数在计算对齐前指定行的宽度时会考虑对齐,有时不考虑对齐。 有关此内容的详细信息,请参阅 GetTextExtentPoint32。 必须知道此宽度,然后才能计算相应的 nBreakExtra 值。

SetTextJustification 可用于对齐包含不同字体的多个字符串的行。 在这种情况下,每个字符串必须单独对齐。

由于在对齐期间可能发生舍入错误,因此系统会保留一个定义当前错误值的正在运行的错误术语。 当对包含多个运行的行进行对齐时, GetTextExtentPoint 在计算下一次运行的范围时会自动使用此错误术语,从而允许 TextOut 将错误混合到新的运行中。 将每行对齐后,必须清除此错误术语,以防止将其合并到下一行。 可以通过调用 SetTextJustification 来清除该术语,并将 nBreakExtra 设置为零。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h (包括 Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

另请参阅

ExtTextOut

字体和文本函数

字体和文本概述

GetTextExtentPoint32

GetTextMetrics

TextOut