Пример увеличения чернил

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

В примере отрисовщик представления и преобразования объектов используются для масштабирования и прокрутки. Преобразование представления применяется к точкам и ширине пера. Преобразование объекта применяется только к точкам. Пользователь может выбирать, какое преобразование использовать, изменяя параметр "Размер пера для изменения масштаба" в меню "Режим".

В этом примере используются следующие функции:

• Объект InkCollector
• Метод объекта SetViewTrans form отрисовщика
• Метод объекта SetObjectTrans form объекта отрисовщика

Инициализация формы

Во-первых, пример ссылается на интерфейсы автоматизации планшетных пк, которые предоставляются в комплекте средств разработки программного обеспечения Windows Vista или Windows XP Tablet PC Edition (SDK).

using Microsoft.Ink;

В примере объявляются InkCollector, myInkCollectorи некоторые приватные члены, помогающие масштабированию.

// Declare the Ink Collector object
private InkCollector myInkCollector = null;
...
// The starting and ending points of the zoom rectangle
private Rectangle zoomRectangle = Rectangle.Empty;

// The current zoom factor (1 = 100% zoom level)
private float zoomFactor = 1;

// Declare constants for the width and height of the 
// drawing area (in ink space coordinates).
private const int InkSpaceWidth = 50000;
private const int InkSpaceHeight = 50000;
...
// Declare constant for the pen width used by this application
private const float MediumInkWidth = 100;

Затем пример создает и включает InkCollector в обработчике события загрузки формы Load. Кроме того, свойство Width объекта InkCollector DefaultDrawingAttributes задано. Наконец, определяются диапазоны полос прокрутки и вызывается метод UpdateZoomAndScroll приложения.

private void InkZoom_Load(object sender, System.EventArgs e)
{
   // Create the pen used to draw the zoom rectangle
    blackPen = new Pen(Color.Black, 1);

    // Create the ink collector and associate it with the form
    myInkCollector = new InkCollector(pnlDrawingArea.Handle);

    // Set the pen width
    myInkCollector.DefaultDrawingAttributes.Width = MediumInkWidth;

    // Enable ink collection
    myInkCollector.Enabled = true;

    // Define ink space size - note that the scroll bars
    // map directly to ink space
    hScrollBar.Minimum = 0;
    hScrollBar.Maximum = InkSpaceWidth;
    vScrollBar.Minimum = 0;
    vScrollBar.Maximum = InkSpaceHeight;

    // Set the scroll bars to map to the current zoom level
    UpdateZoomAndScroll();
}

Обновление значений масштабирования и прокрутки

На область рисования сборщика рукописного ввода влияет множество событий. В методе UpdateZoomAndScroll матрица преобразования используется как для масштабирования, так и для переноса сборщика рукописного ввода в окне.

Наконец, вызывается метод UpdateScrollBars приложения, и форма принудительно обновляется.

// Create a transformation matrix
Matrix m = new Matrix();

// Apply the current scale factor
m.Scale(zoomFactor,zoomFactor);

// Apply the current translation factor - note that since 
// the scroll bars map directly to ink space, their values
// can be used directly.
m.Translate(-hScrollBar.Value, -vScrollBar.Value);

// ...
if (miScalePenWidth.Checked)
{
    myInkCollector.Renderer.SetViewTransform(m);
}
else
{
    myInkCollector.Renderer.SetObjectTransform(m);
}

// Set the scroll bars to map to the current zoom level
UpdateScrollBars();

Refresh();

Управление полосами прокрутки

Метод UpdateScrollBars настраивает полосы прокрутки для корректной работы в соответствии с текущим размером окна, параметром масштабирования и положением прокрутки в InkCollector. Этот метод вычисляет большие и небольшие значения изменений для вертикальных и горизонтальных полос прокрутки. Он также вычисляет текущее значение полос прокрутки и должно ли они быть видимыми. Метод PixelToInk Space объекта отрисовщика обрабатывает преобразование из пикселей в увеличенное пространство координат и учетные записи для любого масштабирования и прокрутки, применяемого через преобразования представления и объекта.

// Create a point representing the top left of the drawing area (in pixels)
Point ptUpperLeft = new Point(0, 0);

// Create a point representing the size of a small change
Point ptSmallChange = new Point(SmallChangeSize, SmallChangeSize);

// Create a point representing the lower right of the drawing area (in pixels)
Point ptLowerRight = new Point(hScrollBar.Width, vScrollBar.Height);

using (Graphics g = CreateGraphics())
{
    // Convert each of the points to ink space
    myInkCollector.Renderer.PixelToInkSpace(g, ref ptUpperLeft);
    myInkCollector.Renderer.PixelToInkSpace(g, ref ptLowerRight);
    myInkCollector.Renderer.PixelToInkSpace(g, ref ptSmallChange);
}

// Set the SmallChange values (in ink space)
// Note that it is necessary to subract the upper-left point
// value to account for scrolling.
hScrollBar.SmallChange = ptSmallChange.X - ptUpperLeft.X;
vScrollBar.SmallChange = ptSmallChange.Y - ptUpperLeft.Y;

// Set the LargeChange values to the drawing area width (in ink space)
// Note that it is necessary to subract the upper-left point
// value to account for scrolling.
hScrollBar.LargeChange = ptLowerRight.X - ptUpperLeft.X;
vScrollBar.LargeChange = ptLowerRight.Y - ptUpperLeft.Y;

// If the scroll bars are not needed, hide them
hScrollBar.Visible = hScrollBar.LargeChange < hScrollBar.Maximum;
vScrollBar.Visible = vScrollBar.LargeChange < vScrollBar.Maximum;

// If the horizontal scroll bar value would run off of the drawing area, 
// adjust it
if(hScrollBar.Visible && (hScrollBar.Value + hScrollBar.LargeChange > hScrollBar.Maximum)) 
{
    hScrollBar.Value = hScrollBar.Maximum - hScrollBar.LargeChange;
}

// If the vertical scroll bar value would run off of the drawing area, 
// adjust it
if(vScrollBar.Visible && (vScrollBar.Value + vScrollBar.LargeChange > vScrollBar.Maximum))
{
    vScrollBar.Value = vScrollBar.Maximum - vScrollBar.LargeChange;
}

Масштабирование до прямоугольника

Обработчики событий панели pnlDrawingArea управляют рисованием прямоугольника на окно. Если команда Zoom To Rect проверяется в меню "Режим", обработчик событий mouseUp вызывает метод ZoomToRectangle приложения. Метод ZoomToRectangle вычисляет ширину и высоту прямоугольника, проверяет условия границы, обновляет значения полосы прокрутки и коэффициент масштабирования, а затем вызывает метод UpdateZoomAndScroll приложения для применения новых параметров.

Закрытие формы

Метод Dispose формы удаляет объект InkCollector.