4.12.4 Вывод точных изображений

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

Иногда, однако, произвольное масштабирование метафайла — не очень хорошая идея. Может оказаться смешным растягивание содержащегося в метафайле образа, в виде лица человека, в толстое или тонкое лицо. В этом случае надо знать правильный относительный размер образа. Некоторые изображения метафайлов могут иметь смысл только при конкретных физических размерах.

Как мы уже видели, последний параметр функции PlayEnhMetaFile — структура типа RECT, сообщающая GDI, где вы хотите нарисовать изображение в приемном контексте устройства. GDI растягивает образ так, чтобы он занял полностью указанный прямоугольник. Точный вывод изображений метафайлов — в заданных метрических размерах или с соответствующим относительным размером, требует использования информации о размерах из заголовка метафайла и точной установки размеров прямоугольника.

4.13 Текст и шрифты

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

4.13.1 Вывод простого текста

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

Наиболее часто используемой функцией вывода текста является функция, которая использовалась в программе SYSMETS в главе 3:

TextOut(hdc, xStart, yStart, pString, iCount);

Параметры xStart и yStart определяют начальную позицию строки в логических координатах. Обычно это точка, в которую Windows помещает верхний левый угол первого символа. TextOut требует также в качестве параметра указатель на символьную строку и длину строки. Эта функция не распознает текстовые строки по NULL символу.

Смысл параметров xStart и yStart функции TextOut может быть изменен с помощью функции SetTextAlign. Флаги TA_LEFT, TA_RIGHT и TA_CENTER влияют на использование xStart при позиционировании строки по горизонтали. По умолчанию установлен флаг TA_LEFT. Если вы установите флаг TA_RIGHT при вызове функции SetTextAlign, то последующие вызовы функции TextOut устанавливают правую границу последнего символа строки в xStart. При заданном флаге TA_CENTER в xStart устанавливается середина строки.

Аналогично, флаги TA_TOP, TA_BOTTOM и TA_BASELINE влияют на вертикальное позиционирование строки.

По умолчанию установлен флаг TA_TOP, который означает, что строка позиционируется таким образом, что yStart определяет вершину символов в строке. Использование флага TA_BOTTOM означает, что строка позиционируется над yStart. Вы можете использовать флаг TA_BASELINE для размещения строки таким образом, чтобы положение базовой линии определялось значением yStart. Базовая линия — это линия, ниже которой располагаются "хвостики" некоторых строчных букв (например, р, q, у).

Если вы вызываете SetTextAlign с флагом TA_UPDATECP, Windows игнорирует параметры xStart и yStart функции TextOut и вместо них использует текущее положение пера, ранее установленное функциями MoveToEx, LineTo или какой-либо другой функцией, изменяющей текущее положение пера. Флаг TA_UPDATECP также заставляет функцию TextOut изменить значение текущего положения пера на конец строки (при установленном флаге TA_LEFT) или на начало строки (при установленном флаге TA_RIGHT). Это используется для отображения строки текста с помощью последовательных вызовов функции TextOut. Когда горизонтальное позиционирование осуществляется при установленном флаге TA_CENTER, текущее положение пера не меняется после вызова функции TextOut.

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

TabbedTextOut(hdc, xStart, yStart, pString, iCount,

iNumTabs, piTabStops, xTabOrigin);

Если строка символов содержит символы табуляции (‘\t’ или 0х09), то функция TabbedTextOut будет при выводе заменять символы табуляции числом пробелов, соответствующих списку целых параметров, которые вы передаете в функцию.

Первые пять параметров функции TabbedTextOut такие же, как у функции TextOut. Шестой параметр — число позиций табуляции, седьмой параметр — массив позиций табуляции, заданных в пикселях. Например, если средняя ширина символа 8 пикселей, и вы хотите установить позиции табуляции через каждые 5 символов, то этот список будет содержать числа 40, 80, 120 и т. д., в порядке возрастания.

Если шестой и седьмой параметры имеют значения 0 или NULL, то позиции табуляции устанавливаются через равные промежутки, равные восьмикратной средней ширине символов. Если шестой параметр равен 1, то седьмой параметр указывает на простое целое, которое каждый раз прибавляется для определения следующей позиции табуляции. (Например, если шестой параметр равен 1, а седьмой параметр является указателем на переменную, содержащую число 30, то позиции табуляции будут установлены так: 30, 60, 90, ... пикселей.) Последний параметр задает логическую координату по горизонтали точки отсчета позиций табуляции. Точка отсчета может совпадать с начальной позицией строки или отличаться от нее.

Примером другой расширенной функции вывода текста является функция ExtTextOut (приставка Ext означает расширенная):

ExtTextOut(hdc, xStart, yStart, iOptions, &rect, pString, iCount, pxDistance);

Пятый параметр этой функции является указателем на прямоугольную структуру. Эта структура является прямоугольником отсечения (если параметр iOptions имеет значение ETO_CLIPPED) или прямоугольником фона, который должен быть закрашен текущим цветом фона (если параметр iOptions имеет значение ETO_OPAQUE). Вы можете задавать обе опции или ни одной.

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

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

DrawText(hdc, pString, iCount, &rect, iFormat);

Так же, как и другие функции вывода текста, функция DrawText требует задания в качестве параметров указателя на символьную строку и длину строки. Однако, при использовании функции DrawText для вывода строки, оканчивающейся символом NULL, вы можете задать значение параметра iCount равным —1. В этом случае Windows вычислит длину строки.

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

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

Вы можете изменить действие функции DrawText по умолчанию, задав значение параметра iFormat, как комбинацию одного или нескольких флагов. Флаг DT_LEFT (установлен по умолчанию) задает выравнивание выводимого текста влево, флаг DT_RIGHT — выравнивание вправо, флаг DT_CENTER — выравнивание по центру относительно левой и правой сторон прямоугольника. Поскольку флаг DT_LEFT имеет значение 0, вы можете не задавать его значение в явном виде, если хотите, чтобы весь выводимый текст был выровнен влево.

Если вы не хотите, чтобы символы возврата каретки и символы конца строки интерпретировались как символы начала новой строки, вы можете включить идентификатор DT_SINGLELINE. В этом случае Windows интерпретирует символы возврата каретки и конца строки как отображаемые символы, а не как управляющие символы. Если вы используете идентификатор DT_SINGLELINE, вам необходимо также задать положение строки по вертикали: вверху прямоугольника (флаг DT_TOP, включен по умолчанию), внизу прямоугольника (флаг DT_BOTTOM) или посередине между верхней и нижней границами прямоугольника вывода (флаг DT_VCENTER).

Когда на экран выводится текст, состоящий из нескольких строк, Windows в обычном режиме заканчивает строки, только встретив символ возврата каретки или символ конца строки. Однако, если строка оказывается длиннее, чем ширина прямоугольника вывода, вы можете использовать флаг DT_WORDBREAK. В этом случае Windows будет обрывать строки в конце слов внутри строки. При выводе любого текста (состоящего из одной строки или многострочного) Windows отсекает ту часть текста, которая попадает за пределы прямоугольника вывода. Вы можете избежать этой ситуации, включив флаг DT_NOCLIP, который также ускоряет выполнение функции. Когда Windows осуществляет вывод на экран текста, состоящего из нескольких строк, то межстрочный интервал обычно выбирается равным высоте символа без учета величины пространства, заданного в шрифте, как межстрочный интервал. Если вы хотите, чтобы величина этого пространства была включена в межстрочный интервал, то вы можете использовать флаг DT_EXTERNALLEADING.

Если текст содержит символы табуляции (‘\t’ или 0х09), вам необходимо включить флаг DT_EXPANDTABS. По умолчанию позиции табуляции установлены через каждые восемь символьных позиций. Вы можете задать разные позиции табуляции, используя флаг DT_TABSTOP. В этом случае старший байт параметра iFormat содержит число символьных позиций для каждой новой позиции табуляции. Однако, здесь рекомендуется избегать использования флага DT_TABSTOP, поскольку старший байт параметра iFormat используется также для некоторых других флагов.