Поделиться через


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, количество байт и функции в юникоде количество WORD.Дополнительные сведения см. в разделе GetCharacterPlacement.

  • nMaxExtent
    Указывает максимальную область памяти (в логических единицах), к которой строка обрабатывается.Символы, если было обработано, превысивших бы эту область памяти, игнорируются.Вычисления всех необходимых массивов или глифа сортировки применяются только к выбранному символам.Этот параметр используется, только если значение GCP_MAXEXTENT указанного в параметре dwFlags.Как функция обрабатывает входную строку, каждый знак и область памяти добавлена к выходу, области памяти и другими массивами, только если общая область еще не превышала максимум.Ограничение достигнуто, останавливает только обработку.

  • lpResults
    Указатель на структуру GCP_RESULTS, которая возвращает результаты функции.

  • dwFlags
    Определяет способ обработки строку в обязательные массивы.Этот параметр может иметь одно или несколько значений, перечисленных в разделе dwFlags разделах GetCharacterPlacement.

  • str
    Указатель на объект CString к процессу.

Возвращаемое значение

Если функция завершается успешно, то возвращаемое значение ширина и высота строки в логических единицах.

Если функция завершается неудачей, то возвращаемое значение равно нулю.

Заметки

Это функция-член эмулируется функциональные возможности функции GetCharacterPlacement, как описано в Windows SDK.

Требования

Header: afxwin.h

См. также

Ссылки

Класс CDC

Диаграмма иерархии

CDC::ExtTextOut

CDC::GetCharABCWidths

CDC::GetTextMetrics