CDC::TabbedTextOut
Эта функция-член вызывается для записи строки символов в заданном месте, развернуть вкладки к значениям, заданным в массиве мест табуляции.
virtual CSize TabbedTextOut(
int x,
int y,
LPCTSTR lpszString,
int nCount,
int nTabPositions,
LPINT lpnTabStopPositions,
int nTabOrigin
);
CSize TabbedTextOut(
int x,
int y,
const CString& str,
int nTabPositions,
LPINT lpnTabStopPositions,
int nTabOrigin
);
Параметры
x
Идентифицирует логический координату x начальной точки строки.y
Идентифицирует логический координату y начальной точки линии.lpszString
Указывает на символьную строку для рисования. Можно передавать или указатель на массив знаков или объект CString для этого параметра.nCount
Указывает число символов в строке. Если nCount 1, то длина вычисляется.nTabPositions
Указывает число значений в массиве мест табуляции.lpnTabStopPositions
Указывает на массив, содержащий позицию табуляции (в логических единицах). Позиции табуляции должен быть отсортирован по возрастанию; наименьшее значение x должен быть первым элементом в массиве.nTabOrigin
Указывает координату x начальной позиции табуляции из которой развернуты (в логических единицах).str
Объект CString, который содержит указанные символы.
Возвращаемое значение
Измерения строки (в логических единицах) как объект CSize.
Заметки
Запись текста выбранного в настоящий момент шрифте. Если nTabPositions 0 и lpnTabStopPositionsNULL, то вкладкам развернуты до 8 раз средняя ширина символов.
Если nTabPositions 1, то позиции табуляции разделяются по диапазону указанным первым значением в массиве lpnTabStopPositions. Если массив lpnTabStopPositions содержит более одного значения, то позиция табуляции устанавливается для каждого значения в массиве до числа, определенного nTabPositions. Параметр nTabOrigin позволяет приложению вызывать функцию TabbedTextOut несколько раз для одной линии. Если приложение вызывает функцию несколько раз с nTabOrigin устанавливаемое с тем же значением, каждый раз, то функция развернуть все вкладки относительно позиции, указанной nTabOrigin.
По умолчанию текущая позиция не используется и не изменялись функцией. Если приложению необходимо обновить текущую позицию, когда он вызывает функцию, приложение может вызвать функцию-член SetTextAlign с nFlags, для TA_UPDATECP. Если пометить установлен, Windows не учитывает параметры x и y при последующих вызовах TabbedTextOut, используя текущее положение.
Требования
Header: afxwin.h