通过

InkCollector.SetWindowInputRectangle 方法

  • 项目

设置在其中绘制墨迹 的窗口矩形（以像素为单位）。

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

语法

声明
Public Sub SetWindowInputRectangle ( _
    windowInputRectangle As Rectangle _
)
用法
Dim instance As InkCollector
Dim windowInputRectangle As Rectangle

instance.SetWindowInputRectangle(windowInputRectangle)

public void SetWindowInputRectangle(
    Rectangle windowInputRectangle
)

public:
void SetWindowInputRectangle(
    Rectangle windowInputRectangle
)

public void SetWindowInputRectangle(
    Rectangle windowInputRectangle
)

public function SetWindowInputRectangle(
    windowInputRectangle : Rectangle
)

参数

备注

默认情况下，窗口输入矩形设置为 {0,0,0,0}。此默认矩形映射到整个窗口的大小。若要将窗口输入矩形重置为具有默认坐标的空矩形，请在对 SetWindowInputRectangle 方法的调用中传递 {0,0,0,0}。

如果 Right 属性的值小于 Left 属性的值，或 Bottom 属性的值小于 Top 属性的值，则不能传递矩形。例如，参数为 {500, 500, 400, 400} 的矩形是无效的。

您可以指定负坐标空间中的矩形，但这种矩形没有意义，因为它始终不是能够进行墨迹书写的窗口。

警告

  如果将窗口输入矩形设置为与 Splitter control（Splitter 控件）或窗口的边框重叠，则调整窗口大小时可能发生不可预知的结果。

备注

如果在某些消息处理程序内调用此函数，则可以重新进入此函数，从而导致意外的结果。在处理以下任一消息时，请注意避免可重入调用：WM_ACTIVATE、WM_ACTIVATEAPP、WM_NCACTIVATE、WM_PAINT；WM_SYSCOMMAND（如果 wParam 设置为 SC_HOTKEY 或 SC_TASKLIST）；以及 WM_SYSKEYDOWN（处理 Alt-Tab 或 Alt-Esc 组合键时）。这是单线程单元模型应用程序的问题。

示例

此 C# 示例调用 SetWindowInputRectangle 方法将墨迹输入区设置为它所附加到的 InkCollector 对象 theInkCollector 的整个窗口的大小。

using Microsoft.Ink;
//...
InkCollector theInkCollector;
public Form1()
{
    // Initialization
    theInkCollector = new InkCollector(Handle);
    Rectangle theRect = new Rectangle(0,0,0,0);
    theInkCollector.SetWindowInputRectangle(theRect);
    //...
}

此 Visual Basic .NET 示例调用 SetWindowInputRectangle 方法将墨迹输入区设置为它附加到的 InkCollector 对象 theInkCollector 的整个窗口的大小。

Imports Microsoft.Ink
Dim theInkCollector As InkCollector
Public Sub Form1()
    'Initialization
    Dim theRect As Rectangle
    theInkCollector = New InkCollector(Handle)
    theRect = New Rectangle(0,0,0,0)
    theInkCollector.SetWindowInputRectangle(theRect)
    '...
End Sub

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。

版本信息

.NET Framework

受以下版本支持：3.0

另请参见

参考

InkCollector 类

InkCollector 成员

Microsoft.Ink 命名空间

InkCollector.GetWindowInputRectangle