检索字符串上各种类型的信息。
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