Шаг 789 - 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 );

Возвращаемое значение
Размерность строки (в логических модулях) как объект CSize.

Параметры
x
Определяет логическую x-координату отправной точки строки.
y
Определяет логическую y-координату отправной точки строки.
lpszString
Укажите на символьную строку, чтобы вывести. Вы можете передавать или указатель на массив символов или объекта CString для этого параметра.
nCount
Определяет число символов в строке. Если nCount -1, длина вычислена.
nTabPositions
Определяет число значений в массиве позиций позиции табуляции.
lpnTabStopPositions
Указатель на массив, содержащий позиции позиции табуляции (в логических модулях). Табуляторы должны сортироваться в увеличивающемся порядке; самое маленькое x-значение должно быть первый элемент в массиве.
nTabOrigin
Определяет x-координату исходной позиции, из которой позиции табуляции расширены (в логических модулях).
Str
Объект CString, который содержит определенные символы.

Замечания
Вызовите эту функцию, чтобы записать символьную строку в определенном расположении, разворачивая позиции табуляции к значениям, определенным в массиве позиций позиции табуляции. Текст написан в настоящее время выбранном шрифте. Если nTabPositions - 0, и lpnTabStopPositions NULL, позиции табуляции расширены до восьми раз средней символьной ширины.
Если nTabPositions 1, табуляторы отделяются расстоянием, определенным первым значением в lpnTabStopPositions массиве. Если lpnTabStopPositions массив содержит больше чем одно значение, табулятор установлен для каждого значения в массиве, до номера, определенного nTabPositions. NTabOrigin параметр позволяет прикладной программе называть функцию TabbedTextOut несколькими разами для одиночной строки. Если вызовы из прикладной программы больше чем один раз с набором nTabOrigin к тому же самому значению каждый раз, функция разворачивают позиции табуляции относительно позиции, определенной nTabOrigin.
По умолчанию, текущая позиция не используется или модифицируется функцией. Если прикладная программа должна модифицировать текущую позицию, когда это вызывает функцию, прикладная программа может вызывать SetTextAlign функцию с набором nFlags к TA_UPDATECP. Когда этот флажок установлен, Windows игнорирует x и y параметры на последующих обращениях к TabbedTextOut, используя текущую позицию вместо этого.


Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем - 4.02.2002