setTextJustification 函数 (wingdi.h)

项目
08/27/2023

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

语法

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