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版本,它是 BYTE 计数,并为Unicode函数是 WORD 计数。 有关更多信息,请参见 GetCharacterPlacement

  • nMaxExtent
    指定最大界限(以逻辑单位)该字符串处理。 因此,如果处理,将超出该区域中的字符被忽略。 所有必需的排序或标志符号计算数组中仅适用于包含的字符。 此参数,仅当 GCP_MAXEXTENT 值。dwFlags 参数,指定使用。 因为函数处理输入字符串,每个字符及其区域添加到输出,区域,同时,其他排列,仅当总区域未超出最大次数。 一旦到达了限制,进程将停止。

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

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

  • str
    为进程 CString 对象的指针。

返回值

如果函数成功,则返回值是字符串的宽度和高度(以逻辑单位的。

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

备注

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

要求

Header: afxwin.h

请参见

参考

CDC 类

层次结构图

CDC::ExtTextOut

CDC::GetCharABCWidths

CDC::GetTextMetrics