лекции / Shchupak_Yu._Win32_API_Razrabotka_prilozheniy_dlya_Windows

Пример использования функции TextOut можно найти в листинге 2.1, а также в некоторых других фрагментах программного кода.

Вывод текста с табуляцией

К сожалению, функция TextOut не обрабатывает управляющие символы, в том чис ле символы перевода строки \n и табуляции \t. Встретив любой такой символ, она просто выведет глиф (для системного шрифта SYSTEM_FONT) или глиф для несистемного шрифта.

В то же время табуляция широко используется в простейших текстовых ре дакторах для выравнивания текста по столбцам, облегчающего восприятие ин формации. Для обеспечения работы с табулированным текстом Windows содер жит функции TabbedTextOut и GetTabbedTextExtent.

Функция TabbedTextOut имеет следующий прототип:

LONG TabbedTextOut(HDC hDC, int X, int Y, LPCTSTR lpString, int nCount, int iNumTabs, CONST LPINT lpnTabStops, int xTabOrigin);

Первые пять параметров имеют то же значение, что и у функции TextOut. Шес той параметр, iNumTabs, определяет количество позиций табуляции. Седьмой па раметр, lpnTabStops, содержит указатель на массив позиций табуляции, заданных в логических единицах. Позиции табуляции должны быть отсортированы в воз растающем порядке.

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

Последний параметр, xTabOrigin, задает логическую координату по горизонтали точки отсчета позиций табуляции. Часто бывает удобно определить эту точку так, чтобы она совпадала с начальной позицией вывода строки, поскольку в этом случае массив lpnTabStops перестает быть зависимым от конкретной позиции вывода.

Если выводимая строка содержит символы табуляции \t, то GDI отображает начало строки, пока не обнаружит символ табуляции. После этого GDI просмат ривает массив позиций табуляций, и если первая позиция подходит для продол

жения вывода (то есть она находится правее границы последнего выведенного символа строки), то вывод продолжается с этой позиции. В противном случае GDI берет следующую позицию из массива и проверяет ее и т. д. То же самое происхо дит при обнаружении следующего символа табуляции. Таким образом, функция не гарантирует, что символы после n го символа табуляции будут выводиться в n й позиции табуляции.

Позиции табуляции в массиве lpnTabStops могут быть отрицательными. В этом случае GDI использует абсолютное значение указанной величины, но выравни вает текст по правому краю перед заданной позицией, вместо выравнивания по левому краю после нее.

В случае успешного завершения функция TabbedTextOut возвращает 32 разрядное число, старшее слово которого содержит высоту, а младшее — ширину выведенной строки. В случае неудачного завершения работы возвращается нулевое значение.

Функция GetTabbedTextExtent возвращает размеры табулированного текста, не выводя его.

Следующий фрагмент кода показывает пример использования функции TabbedTextOut. Оконная процедура, код которой приводится ниже, обеспечива ет вывод на экран небольшой таблицы:

LRESULT CALLBACK WndProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)

{

switch (uMsg)

{

case WM_PAINT:

hDC = BeginPaint(hWnd, &ps);

for (i = 0; i < 4; i++) { if (i == 1) y += 10;

y += HIWORD(TabbedTextOut(hDC, x, y, lines[i], strlen(lines[i]), sizeof(tabstop)/sizeof(int), tabstop, x));

}

EndPaint(hWnd, &ps); break;

case WM_DESTROY: PostQuitMessage(0); break;

default:

return DefWindowProc(hWnd, uMsg, wParam, lParam);

}

return 0;

}

Таблица формируется в цикле for. Обратите внимание на то, что значение, воз вращаемое функцией TabbedTextOut, мы используем для вычисления смещения, что бы получить координату y следующей строки выводимого текста. Последнему па раметру функции передается то же значение x, которое задает абсциссу начала вывода строки. Поэтому, определяя абсолютные значения позиций табуляции, GDI прибавляет к величинам, извлекаемым из массива tabstop, величину x. Результат работы этого кода показан на рис.2.28.

Заметим, что горизонтальная линейка, показывающая физические координаты по горизонтали, нарисована соответствующими вызовами функций MoveToEx, LineTo и TextOut. Чтобы не загромождать пример, эти инструкции в программе не пока заны. Обратите внимание на выравнивание по правому краю второго столбца таб лицы относительно позиции 180, вычисленной в результате сложения 50 + 130.

Рис. 2.28. Вывод табулированного текста

Межсимвольные интервалы

В контексте устройства имеется специальный атрибут, управляющий расстоя нием между символами, — межсимвольный интервал (extra space). Межсимволь ный интервал добавляется к каждому символу, включая символы пробела, ког да GDI выводит строку текста. По умолчанию этот атрибут равен нулю. Функция SetTextCharacterExtra присваивает ему новое целочисленное значение в логичес ких единицах, возвращая предыдущее значение. Функция GetTextCharacterExtra возвращает текущее значение межсимвольного интервала.

Межсимвольные интервалы могут использоваться как для разрядки, так и для уплотнения текста. Чтобы почувствовать, какие возможности дает функ ция SetTextCharacterExtra, модифицируйте предыдущую программу следующим образом. Фрагмент с циклом for надо заменить таким кодом:

SetTextCharacterExtra(hDC, 4); for (i = 0; i < 4; i++) {

if (i == 1) { y += 10;

SetTextCharacterExtra(hDC, 0);

}

y += HIWORD(TabbedTextOut(hDC, x, y, lines[i], strlen(lines[i]), sizeof(tabstop)/sizeof(int), tabstop, x));

}

После этого запустите программу и посмотрите, как изменится отображение текста на экране.

Выравнивание по ширине (выключка1)

Функция TextOut обеспечивает выравнивание текста по левому или правому краю, а также по центру. Вид выравнивания зависит от текущего режима выравнива

1Типографский термин, означающий увеличение межсловных интервалов в строке для выравнива ния по ширине.

Листинг 2.1. Проект TextJust

//////////////////////////////////////////////////////////////////////

// TextJust.cpp #include <windows.h> #include "KWnd.h"

LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);

BOOL TextJustOut(HDC hdc, int x, int y, LPCTSTR lpStr, int width, char breakChar = ' ');

//////////////////////////////////////////////////////////////////////

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow)

{

MSG msg;

KWnd mainWnd("Text Justification", hInstance, nCmdShow, WndProc);

while (GetMessage(&msg, NULL, 0, 0)) { TranslateMessage(&msg); DispatchMessage(&msg);

}

return msg.wParam;

}

//////////////////////////////////////////////////////////////////////

LRESULT CALLBACK WndProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)

{

HDC hDC; PAINTSTRUCT ps;

char* text[6] =

{"Рассуждай", "Рассуждай токмо",

"Рассуждай токмо о том",

"Рассуждай токмо о том, о чем понятия", "Рассуждай токмо о том, о чем понятия твои тебе",

"Рассуждай токмо о том, о чем понятия твои тебе сие дозволяют."

};

int x = 20, y = 20; SIZE size;

int nWidth, i;

switch (uMsg)

{

case WM_PAINT:

hDC = BeginPaint(hWnd, &ps);

GetTextExtentPoint32(hDC, text[5], strlen(text[5]), &size); nWidth = size.cx;

for (i = 0; i < 6; i++) {

TextJustOut(hDC, x, y, text[i], nWidth); y += size.cy + 2;

}

EndPaint(hWnd, &ps);

продолжение

Листинг 2.1 (продолжение)

break;

case WM_DESTROY: PostQuitMessage(0); break;

default:

return DefWindowProc(hWnd, uMsg, wParam, lParam);

}

return 0;

}

//////////////////////////////////////////////////////////////////////

BOOL TextJustOut(HDC hdc, int x, int y, LPCTSTR lpStr, int width, TCHAR breakChar)

{

SIZE size;

int nCount = strlen(lpStr);

SetTextJustification(hdc, 0, 0);

GetTextExtentPoint32(hdc, lpStr, nCount, &size);

int nBreak = 0;

for (int i = 0; i < nCount; ++i) if (lpStr[i] == breakChar)

nBreak++;

int breakExtra = width - size.cx; if (breakExtra < 0) breakExtra = 0;

SetTextJustification(hdc, breakExtra, nBreak); return TextOut(hdc, x, y, lpStr, nCount);

}

//////////////////////////////////////////////////////////////////////

В проекте используется класс KWnd, поэтому не забудьте скопировать в каталог проекта файлы KWnd.h и KWnd.cpp, код которых приведен в листинге 1.2, и подклю чить их в состав проекта при помощи окна Project Workspace интегрированной среды.

Код, отвечающий за выравнивание по ширине, инкапсулирован в функцию TextJustOut. В оконной процедуре функция TextJustOut вызывается, чтобы вывести шесть строк из массива text. Ширина области вывода nWidth определяется по самой длинной строке с адресом text[5]. Результат работы программы показан на рис. 2.29.

Рис. 2.29. Выравнивание текста по ширине

Абзацное форматирование в прямоугольнике

В пользовательском интерфейсе Windows часто требуется вывести длинный текст в прямоугольнике, способном вместить несколько строк. Или, напротив, короткий текст поместить в прямоугольнике с учетом заданного позиционирования. Для ре шения подобных проблем Win32 GDI предоставляет функции DrawText и DrawTextEx.

Так же как и другие функции вывода текста, функция DrawText принимает в ка честве параметров указатель на символьную строку и длину строки. Однако функ ция ведет себя более интеллектуально по отношению к строкам с завершающим нулевым символом. Вы можете передать значение –1 на месте параметра nCount, и функция сама определит длину строки. Если же строка не имеет завершающего нулевого символа, то благоразумнее будет указать ее длину в аргументе nCount.

Функция DrawText выводит текстовую строку в прямоугольной области, задан ной параметром lpRect. Последний параметр, uFormat, определяет метод формати рования текста. Его значение представляет собой битовую маску, образованную объединением флагов форматирования. Наиболее часто употребляемые флаги приведены в табл. 2.31 (полный перечень флагов см. в MSDN).

Таблица 2.31. Флаги форматирования для функции DrawText

Если параметр uFormat имеет нулевое значение, то Windows интерпретирует текст как ряд строк, разделенных символами возврата каретки (‘\r’ или 0x0D) или символами конца строки (‘\n’ или 0x0A). Вывод текста производится, начиная с верхнего левого угла прямоугольника. Возврат каретки или конец строки вос принимаются как команда перейти на новую строку. Вывод новой строки начина ется под предыдущей строкой с интервалом, равным высоте символа в строке.

Любой текст, в том числе и части букв, попадающие при выводе правее или ниже границ прямоугольника, отсекаются. Можно предотвратить потерю текста от отсечения по правой границе, задав флаг DT_WORDBREAK.

Если выводится короткий текст, то рекомендуется указывать флаг DT_ SINGLELINE. Это позволяет использовать все флаги позиционирования текста в прямоугольнике.

В случае успешного завершения функция DrawText обычно возвращает высоту выведенного текста. Для многострочного текста возвращается суммарная высота всех строк. Исключение составляют случаи использования функции с флагом DT_VCENTER или DT_BOTTOM. В этих двух случаях функция возвращает смещение нижней границы текста относительно верхней границы прямоугольника.

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

Покажем примеры использования функции DrawText. На рис. 2.30 приведен результат трехкратного вызова функции

DrawText(hDC, text1, -1, &rect, uFormat);

для вывода строки

char text1[] = "&Open C:\\WINNT\\system32\\gdi32.dll";

со следующими значениями параметра uFormat: а) 0;

б) DT_SINGLELINE | DT_CENTER | DT_VCENTER | DT_NOPREFIX;

в) DT_SINGLELINE | DT_RIGHT | DT_BOTTOM.

Прямоугольник rect отображен на рисунке дополнительным вызовом функ ции Rectangle.

Рис. 2.30. Вывод строки text1 с разным позиционированием в прямоугольнике rect

На рис. 2.31 демонстрируется вывод этого же текста в более узком прямо угольнике, который не может уместить весь текст. Трем вызовам функции соот ветствуют значения параметра uFormat:

а) 0;

б) DT_SINGLELINE | DT_VCENTER | DT_END_ELLIPSIS;

в) DT_SINGLELINE | DT_BOTTOM | DT_PATH_ELLIPSIS.

Обратите внимание на то, что при первом вызове функции DrawText конец стро ки отсекается, при втором — хвостовой фрагмент строки заменяется многоточием, при третьем — замена многоточием осуществляется в средней части, чтобы пока зать завершающую часть строки.