находится цикл, который перебирает все строки документа, вызывая метод
Graphics.DrawString
для рисования каждой из них. Остальная часть этого кода связана в основном с оптимизацией рисования — обычный материал для определения, что действительно необходимо нарисовать вместо необдуманного приказания экземпляру Graphics перерисовать все.
Мы начинаем с проверки, имеются ли в документе какие-либо данные. Если данных нет, мы выводим краткое сообщение, говорящее об этом вызываем реализацию
OnPaint
из базового класса и выходим. Если имеются данные, то мы начинаем проверять прямоугольник вырезания. Способ, которым это делается, состоит в вызове другого написанного нами метода
WorldYCoordinateToLineIndex
. Мы рассмотрим этот метод позже, но по сути он получает заданную у-позицию относительно верха документа и определяет, какая строка документа будет выводиться в этой точке.
При первом вызове метода
WorldYCoordinateToLineIndex
ему передается значение координаты
е.ClipRectangle.Top - scrollPositionY
. Это верх области вырезания, преобразованный в мировые координаты. Если возвращаемое значение будет -1, мы предположим, что нам нужно начать с начала документа (если верх области вырезания находится наверху граничного поля).
После того, как все это будет сделано, мы практически повторяем тот же процесс для низа прямоугольника вырезания, чтобы определить последнюю строку документа, которая находится внутри области вырезания. Индексы первой и последней строки хранятся соответственно в
minLineInClipRegion
и
maxLineInClipRegion
, поэтому мы можем просто выполнить цикл
for
между этими значениями, чтобы реализовать рисование. Внутри цикла рисования мы должны сделать приблизительно обратное преобразование для преобразования, выполненного методом
WorldYCoordinateToLineIndex
. Задан индекс строки текста и нужно проверить, где она должна быть нарисована. Это вычисление является вполне простым, но мы поместили его в другой метод
LineIndexToWorldCoordinates
, который возвращает требуемые координаты верхнего левого угла элемента. Возвращаемые координаты являются мировыми координатами, и это хорошо, так как мы уже вызвали метод
TranslateTransform
на объекте Graphics, поэтому нам нужно передать ему при запросе вывода элемента мировые координаты, а не координаты страницы.
Преобразования координат
В этом разделе мы рассматриваем реализацию вспомогательных методов, которые были использованы в примере
CapsEditor
, чтобы выполнить преобразование координат. Это методы
WorldYCoordinateToLineIndex
и
LineIndexToWorldCoordinates
, на которые мы ссылались в предыдущем разделе, а также некоторые другие методы.
Первое.
LineIndexToWorldCoordinates
получает заданный индекс строки и определяет мировые координаты верхнего левого угла строки с помощью известных ширины поля и высоты
строки:
private Point LineIndexToWorldCoordinates(int index) {
Point TopLeftCorner =
new Point((int)margin, (int)(lineHeight*index + margin));
return TopLeftCorner;
}
Мы также используем метод, который делает приблизительно обратное преобразование в
OnPaint
.
WorldYCoordinateToLineIndex
определяет индекс строки, но он принимает в расчет только вертикальную мировую координату. Это связано с тем, что метод используется для определения индекса строки, соответствующего верху и низу области вырезания:
private int WorldYCoordinateToLineIndex(int у) {
if (у < margin) return -1;
return (int)((y - margin)/lineHeight);
}
Существуют еще три метода, вызываемые из процедуры обработки, которые отвечают на двойной щелчок пользователя мышью. Прежде всего — метод, определяющий индекс строки, которая выведется в заданных мировых координатах. В отличие от
WorldYCoordinateToLineIndex
этот метод берет в расчет позиции x- и y- координат. Он возвращает -1, если нет строки текста с заданными координатами.
private int WorldCocrdinatesToLineIndex(Point position) {
if (!documentHasData) return -1;
if (position.Y < margin || position.X < margin) return -1;
int index = (int) (position.Y - margin) / (int) this.lineHeight;
// проверить, что позиция находится не ниже документа
if (index >= documentLines.Count) return -1;
// теперь проверим, что горизонтальная позиция располагается
// внутри строки
TextLineInformation theLine =
(TextLineInformation)documentLines[index];
if (position.X > margin * theLine.Width)
return -1;
// все хорошо. Можно вернуть ответ.
return index;
}
Наконец, иногда необходимо делать преобразование между индексом строки и координатами страницы, а не мировыми координатами. Это делает следующий метод:
private Point LineIndexToPageCoordinates(int index) {
return LineIndexToWorldCoordinates(index) + new Size(AutoScrollPosition);
}
private int PageCoordinatesToLineIndex(Point position) {
return WorldCoordinatesToLineIndex(position - new Size(AutoScrollPosition));
}
Эти методы сами по себе не кажутся особенно интересными, они иллюстрируют общую технику, которую, по всей видимости, вам придется часто использовать. Применяя GDI+, мы иногда оказываемся в ситуации где заданы некоторые координаты (например, координаты места, где пользователь щелкнул мышью) и требуется определить, какой элемент изображен в этом месте. Или наоборот, для заданного определенного элемента вывода необходимо приблизительно определить, где он должен быть выведен. Следовательно, при создании приложений GDI+ может оказаться полезным умение написать методы, эквивалентные методам преобразований координат, проиллюстрированным здесь.