CDC::GetCharacterPlacement

检索字符串上各种类型的信息。

DWORD GetCharacterPlacement(
   LPCTSTR lpString,
   int nCount,
   int nMaxExtent,
   LPGCP_RESULTS lpResults,
   DWORD dwFlags
) const;
DWORD GetCharacterPlacement(
   CString& str,
   int nMaxExtent,
   LPGCP_RESULTS lpResults,
   DWORD dwFlags
) const;

参数

  • lpString
    指向要处理的字符串的指针。

  • nCount
    指定字符串的长度。 对于 ANSI 版本为字节数,而对于 Unicode 函数则为字数。 有关更多信息,请参阅获取字符替换

  • nMaxExtent
    指定该字符串处理的最大界限(以逻辑单位)。 会超出该范围的字符(如果经过处理)会被忽略。 针对所有必需的排序或字形数组的计算仅适用于包含的字符。 该参数仅当在 dwFlags 参数中指定 GCP_MAXEXTENT 值时才使用。 在函数处理输入字符串时,只有在总范围未超出最大值的情况下,每个字符及其范围才会添加到输出、范围和其他数组。 达到了限制之后,进程将停止。

  • lpResults
    用于接收函数结果的 GCP_Results 结构的指针。

  • dwFlags
    指定如何将该字符串处理到所需的数组中。 此参数可以是 GetCharacterPlacement 主题的 dwFlags 节中列出的一个或多个值。

  • str
    指向要处理的 CString 对象的指针。

返回值

如果函数成功,返回值将为逻辑单元中的字符串的宽度和高度。

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

备注

此成员函数可以模拟函数 GetCharacterPlacement 的功能,如 Windows SDK 中所述。

要求

标头: afxwin.h

请参见

参考

CDC 类

层次结构图

CDC::ExtTextOut

CDC::GetCharABCWidths

CDC::GetTextMetrics