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


CDC::GetTabbedTextExtent

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

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

Параметры

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

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

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

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

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

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

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

Заметки

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

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

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

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

Требования

Header: afxwin.h

См. также

Ссылки

Класс CDC

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

CDC::GetTextExtent

CDC::GetOutputTabbedTextExtent

CDC::GetOutputTextExtent

CDC::TabbedTextOut

GetTabbedTextExtent

Класс CSize