C# для профессионалов. Том II - Симон Робинсон

Теперь, когда мы знаем размер каждого элемента на экране и можем вычислить приблизительное его положение, определим реальный размер документа. Высота, по существу, равна числу строк, умноженному на высоту каждой строки. Ширину необходимо определить просмотром всех строк, чтобы выявить самую длинную и взять ширину этой строки. Для высоты и ширины также желательно допустить небольшие поля вокруг выводимого документа, чтобы приложение выглядело более привлекательно. (Нежелательно, чтобы текст прикасался к одному из углов клиентской области.) Вот метод, который вычисляет размер документа:

private void CalculateDocumentSize() {

 if (!documentHasData) {

  documentSize = new Size(100, 200);

 } else {

  documentSize.Height = (int)(nLines*lineHeight) + 2*(int)margin;

  uint maxLineLength = 0;

  foreach (TextLineInformation nextWord in documentLines) {

   uint tempLineLength = nextWord.Width + 2*margin;

   if (tempLineLength > maxLineLength) maxLineLength = tempLineLength;

  }

  documentSize.Width = (int)maxLineLength;

 }

 this.AutoScrollMinSize = documentSize;

}

Этот метод сначала проверяет, есть ли данные для вывода. Если данных нет, мы слегка схитрим и зададим жестко кодированный размер документа такой величины, чтобы хватило места для выведения большими красными буквами предупреждения <Empty Document>. В противном случае необходимо воспользоваться методом MeasureString() для определения реального размера документа.

После этого размер документа сообщается экземпляру класса Form, задавая свойство Form.AutoScrollMinSize. Когда это сделано, за сценой происходит кое-что интересное. В процессе задания этого свойства клиентская область становится недействительной и инициируется событие Paint в связи с тем, что изменение размера документа означает необходимость добавить или изменить панели прокрутки, а также, что вся клиентская область почти наверняка будет перерисована. Это в полной мере иллюстрирует то, что было сказано ранее об использовании метода Form.Invalidate(). Если вернуться назад к коду LoadFile(), то станет понятно, что вызов метода Invalidate() в этом методе является на самом деле излишним. Клиентская область будет объявлена недействительной в любом случае, когда задается размер документа. Явный вызов метода Invalidate() в реализации метода LoadFile() оставлен для иллюстрации. Фактически в этом случае все, что будет делать вызванный метод Invalidate(), является ненужным запросом повторного события Paint. Однако это в свою очередь подтверждает, что Invalidate() дает Windows возможность оптимизировать производительность. Второе событие Paint не будет фактически инициировано: Windows увидит, что в очереди уже находится событие Paint, и сравнит запрошенные недействительные области, чтобы попробовать объединить их. В этом случае оба события Paint будут определять всю клиентскую область, поэтому ничего не нужно делать, и Windows спокойно удалит второй запрос Paint. Конечно, это действие займет какое-то процессорное время, но оно будет ничтожным по сравнению с тем, сколько времени потребуется для реального выполнения рисования.

OnPaint()

Итак, мы увидели, как CapsEditor загружает файл. Теперь пришло время посмотреть, как выполняется рисование:

protected override void OnPaint(PaintEventArgs e) {

 Graphics dc = e.Graphics;

 int scrollPositionX = this.AutoScrollPosition.X;

 int scrollPositionY = this.AutoScrollPosition.Y;

 dc.TranslateTransform(scrollPositionX, scrollPositionY);

 if (!documentHasData) {

  dc.DrawString("<Empty Document>", emptyDocumentFont,

   emptyDocumentBrush, new Point(20, 20));

  base.OnPaint(e);

 return;

 }

 // определить, какие строки находятся в вырезанном прямоугольнике

 int minLineInClipRegion =

  WorldYCoordinateToLineIndex(е.ClipRectangle.Top - scrollPositionY);

 if (minLineInClipRegion == -1) minLineInClipRegion = 0;

 int maxLineInClipRegion =

  WorldYCoordinateToLineIndex(e.ClipRectangle.Bottom - scrollPositionY);

 if (maxLineInClipRegion >= this.documentLines.Count || maxLineInClipRegion == -1)

  maxLineInClipRegion = this.documentLines.Count - 1;

 TextLineInformation nextLine;

 for (int i = minLineInClipRegion; i <= maxLineInClipRegion; i++) {

  nextLine = (TextLineInformation)documentLines[i];

  dc.DrawString(nextLine.Text, mainFont, mainBrush, this.LineIndexToWorldCoordinates(i));

 }

base.OnPaint(e);

}

В середине этой перезагружаемой версии OnPaint() находится цикл, который перебирает все строки документа, вызывая метод 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;

 // все хорошо. Можно вернуть ответ.