Amostra de zoom de tinta

Este programa de exemplo demonstra como ampliar e rolar tinta. Em particular, ele permite que o usuário aumente e diminua o zoom da tinta em incrementos. Ele também demonstra como ampliar uma região específica usando um retângulo de zoom. Finalmente, este exemplo ilustra como coletar tinta em diferentes proporções de zoom e como configurar a rolagem dentro da área de desenho ampliada.

No exemplo, a vista e as transformações de objeto do objeto renderizador são usadas para executar zoom e deslocamento. A transformação de visualização aplica-se aos pontos e à largura da caneta. A transformação de objeto aplica-se apenas aos pontos. O utilizador pode controlar qual transformação é usada alterando o item Largura da Caneta de Escala no menu Modo.

Os seguintes recursos são usados neste exemplo:

• O objeto InkCollector
• O Renderer método de SetViewTransform do objeto
• O Renderer método de SetObjectTransform do objeto

Inicializando o formulário

Primeiro, o exemplo faz referência às interfaces de automação do Tablet PC, que são fornecidas no Windows Vista ou Windows XP Tablet PC Edition Software Development Kit (SDK).

using Microsoft.Ink;

O exemplo declara um InkCollector, myInkCollectore alguns membros particulares para ajudar com o dimensionamento.

// 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;

Em seguida, o exemplo cria e habilita o InkCollector no manipulador de eventos Load do formulário. Além disso, a propriedade Width da propriedade DefaultDrawingAttributes do objeto InkCollector é definida. Finalmente, os intervalos da barra de rolagem são definidos e o método UpdateZoomAndScroll do aplicativo é chamado.

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();
}

Atualizando os valores de zoom e rolagem

A área de desenho do coletor de tinta é afetada por muitos eventos. No método UpdateZoomAndScroll, uma matriz de transformação é usada para dimensionar e traduzir o coletor de tinta dentro da janela.

Finalmente, o método UpdateScrollBars do aplicativo é chamado e o formulário é forçado a atualizar.

// 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();

Gerenciando as barras de rolagem

O método UpdateScrollBars configura as barras de rolagem para funcionar corretamente com o tamanho atual da janela, a configuração de zoom e o local de rolagem dentro do InkCollector. Este método calcula os valores de grande e pequena alteração para as barras de rolagem verticais e horizontais. Ele também calcula o valor atual das barras de rolagem e se elas devem estar visíveis. O Renderermétodo de PixelToInkSpace do objeto lida com a conversão de pixels para o espaço de coordenadas ampliado e contabiliza qualquer dimensionamento e rolagem aplicados através das transformações de exibição e objeto.

// 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;
}

Ampliando para um retângulo

Os manipuladores de eventos do painel pnlDrawingArea gerenciam o desenho do retângulo para a janela. Se o comando Zoom To Rect estiver marcado no menu Modo, o manipulador de eventos MouseUp chamará o método ZoomToRectangle do aplicativo. O método ZoomToRectangle calcula a largura e a altura do retângulo, verifica as condições de limite, atualiza os valores da barra de rolagem e o fator de escala e, em seguida, chama o método UpdateZoomAndScroll do aplicativo para aplicar as novas configurações.

Fechando o formulário

O método Dispose do formulário elimina o objeto InkCollector.