Renderer.Draw 方法 (IntPtr, Strokes)

项目
10/28/2008

在传入其句柄的设备上下文上绘制 Strokes 集合。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
<UIPermissionAttribute(SecurityAction.Demand, Window := UIPermissionWindow.SafeTopLevelWindows)> _
<SecurityPermissionAttribute(SecurityAction.Demand, UnmanagedCode := True)> _
Public Sub Draw ( _
    hdc As IntPtr, _
    strokes As Strokes _
)
用法
Dim instance As Renderer
Dim hdc As IntPtr
Dim strokes As Strokes

instance.Draw(hdc, strokes)

[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
[UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction.Demand, UnmanagedCode = true)]
public void Draw(
    IntPtr hdc,
    Strokes strokes
)

[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
[UIPermissionAttribute(SecurityAction::Demand, Window = UIPermissionWindow::SafeTopLevelWindows)]
[SecurityPermissionAttribute(SecurityAction::Demand, UnmanagedCode = true)]
public:
void Draw(
    IntPtr hdc, 
    Strokes^ strokes
)

/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
/** @attribute UIPermissionAttribute(SecurityAction.Demand, Window = UIPermissionWindow.SafeTopLevelWindows) */
/** @attribute SecurityPermissionAttribute(SecurityAction.Demand, UnmanagedCode = true) */
public void Draw(
    IntPtr hdc,
    Strokes strokes
)

public function Draw(
    hdc : IntPtr, 
    strokes : Strokes
)

参数

hdc
类型：System.IntPtr
要在其上进行绘制的设备上下文的句柄。

strokes
类型：Microsoft.Ink.Strokes
要绘制的 Strokes 集合。

备注

请尽可能使用接受 Graphics 对象的合适重载，而不是接受 IntPtr 的重载。

将基于使用 SetViewTransform 方法的方式相应地调整笔的宽度。具体而言，笔宽度将乘以（或调整为）视图变换的行列式的平方根。

备注

如果未显式设置笔宽度，则默认值为 53。只有将笔宽度乘以行列式的平方根才能得到正确的边界框。边界框的高度和宽度在每个方向上扩展该数量的一半。

例如，如果笔宽度为 53，行列式的平方根为 50，边界框为 (0, 0, 1000, 1000)。根据笔宽度，边界框在每个方向上的调整计算方法为 (53 * 50) / 2，右侧和下方增加一个单位。这样，将呈现出边界框 (-1325,-1325,2326,2326)。

Renderer 对象将视区和窗口原点强制到 0,0。将保存和还原任何现有设置，但 Renderer 不使用这些设置。若要执行滚动，请使用 Renderer 对象的 GetViewTransform 和 GetObjectTransform 方法。

安全说明：
如果在部分信任环境下使用，则除了 InkCollector 需要的权限以外，此方法还需要 SecurityPermissionFlag.UnmanagedCode 权限。有关安全问题和部分信任的更多信息，请参见Security and Trust。

示例

在此示例中，与 InkOverlay 对象关联的 Ink 对象中的整个 Strokes 集合将显示在不与 InkOverlay 对象自身关联的一个 Panel 上。这是通过调用 Draw 方法实现的，调用时将不与 InkOverlay 对象关联的一个不同的设备上下文句柄传递给 hdc 参数。

' Access to the Ink.Strokes property returns a copy of the Strokes object.
' This copy must be implicitly (via using statement) or explicitly
' disposed of in order to avoid a memory leak.
Using allStrokes As Strokes = mInkOverlay.Ink.Strokes
    ' get a graphics object for another panel
    Using g As Graphics = Me.panelForDraw.CreateGraphics()
        ' get a Renderer object. We could have used
        ' mInkOverlay.Renderer, this is another way
        Dim R As Renderer = New Renderer()
        ' get the handle to the device context
        Dim hdc As IntPtr = g.GetHdc()
        ' draw the strokes
        R.Draw(hdc, allStrokes)
        ' release the handle to the device context
        g.ReleaseHdc(hdc)
    End Using
End Using

// Access to the Ink.Strokes property returns a copy of the Strokes object.
// This copy must be implicitly (via using statement) or explicitly
// disposed of in order to avoid a memory leak.
using (Strokes allStrokes = mInkOverlay.Ink.Strokes)
{
    // get a graphics object for another panel
    using (Graphics g = this.panelForDraw.CreateGraphics())
    {
        // get a Renderer object. We could have used
        // mInkOverlay.Renderer, this is another way
        Renderer R = new Renderer();
        // get the handle to the device context
        IntPtr hdc = g.GetHdc();
        // draw the strokes
        R.Draw(hdc, allStrokes);
        // release the handle to the device context
        g.ReleaseHdc();
    }
}