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


CDC::GetOutputTabbedTextExtent

Эта функция-член вызывается с целью вычисления ширины и высоты символьной строки с помощью m_hDC, контекст устройства вывода.

CSize GetOutputTabbedTextExtent(
   LPCTSTR lpszString,
   int nCount,
   int nTabPositions,
   LPINT lpnTabStopPositions 
) const;
CSize GetOutputTabbedTextExtent(
   const CString& str,
   int nTabPositions,
   LPINT lpnTabStopPositions 
) const;

Параметры

  • lpszString
    Указывает на символьную строку для измерения.Можно также передать объект CString для этого параметра.

  • nCount
    Указывает число символов в строке.Если nCount 1, то длина вычисляется.

  • nTabPositions
    Указывает число позиций табуляции в массиве, указанному в lpnTabStopPositions.

  • lpnTabStopPositions
    Указывает на массив целых чисел, содержащую позиции табуляции в логических единицах.Позиции табуляции должен быть отсортирован по возрастанию; наименьшее значение x должен быть первым элементом в массиве.Задние вкладки не разрешены.

  • str
    Объект CString, который содержит указанные символы для измерения.

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

Измерения строки (в логических единицах) в объекте CSize.

Заметки

Если строка содержит один или несколько знаков табуляции, то ширина линии основана на позиции табуляции, определенных lpnTabStopPositions.Функция использует текущий выбранный шрифт для вычисления измерения строки.

Текущая область обрезки не offsets ширину и высоту, возвращаемые функцией GetOutputTabbedTextExtent.

Поскольку некоторые устройства не устанавливаются символы в обычных массивов ячейки (то есть их кернинг символы), представляет сумму областей знаков в строке не может быть равна в количества строк.

Если nTabPositions 0 и lpnTabStopPositionsNULL, то вкладкам развернуты до 8 средних значений ширины символов.Если nTabPositions 1, то позиции табуляции будут разделены по диапазону указанным первым значением в массиве, в который lpnTabStopPositions маркеров.Если точки lpnTabStopPositions к более одного значения, позицию табуляции устанавливаются для каждого значения в массиве до числа, определенного nTabPositions.

Требования

Header: afxwin.h

См. также

Ссылки

Класс CDC

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

CDC::GetTextExtent

CDC::m_hAttribDC

CDC::m_hDC

CDC::GetTabbedTextExtent

CDC::GetOutputTextExtent

CDC::TabbedTextOut

GetTabbedTextExtent

Класс CSize