筆跡縮放範例

發行項
06/13/2023

此範例程式示範如何縮放和捲動筆跡。特別是，它可讓使用者以遞增方式放大和縮小筆跡。它也會示範如何使用縮放矩形來放大特定區域。最後，此範例說明如何以不同的縮放比例收集筆跡，以及如何在縮放繪圖區域內設定捲動。

在範例中， Renderer 物件的檢視和物件轉換是用來執行縮放和捲動。檢視轉換適用于點和手寫筆寬度。物件轉換只適用于點。使用者可以藉由變更 [模式] 功能表上的 [縮放筆寬度] 專案來控制所使用的轉換。

注意

在某些介面方法上執行某些 COM 呼叫有問題， (InkRenderer.SetViewTransform 和 InkRenderer.SetObjectTransform，例如當訊息已傳送時) 。當訊息為 SENT 時，必須將訊息封送處理至 POST 訊息佇列。若要解決此案例，請呼叫 InSendMesssageEx 並將訊息張貼至您自己，以測試是否要從 POST 處理訊息。

此範例會使用下列功能：

初始化表單

首先，範例會參考 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;

然後，範例會在表單的Load事件處理常式中建立並啟用InkCollector。此外，會設定 InkCollector 物件的DefaultDrawingAttributes屬性的Width屬性。最後，會定義捲軸範圍，並呼叫應用程式的 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 ，轉換矩陣用於縮放和轉譯視窗內的筆跡收集器。

注意

Renderer物件的SetViewTransform方法會將轉換套用至筆劃和畫筆寬度，而SetObjectTransform方法只會將轉換套用至筆劃。

最後，會呼叫應用程式的 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內的目前視窗大小、縮放設定和捲動位置正確運作。這個方法會計算垂直和水準捲軸的大型變更和小型變更值。它也會計算捲軸的目前值，以及是否應該顯示它們。 Renderer物件的PixelToInkSpace方法會處理從圖元到縮放座標空間的轉換，並考慮透過檢視和物件轉換套用的任何縮放和捲動。

// 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 物件。

共用方式為