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
)

參數

• windowInputRectangle
  型別：System.Drawing.Rectangle
  輸入用的矩形。

備註

根據預設，視窗輸入矩形會設定為 {0,0,0,0}。這個預設矩形對應至整個視窗的大小。若要將視窗輸入矩形重設為預設座標的空矩形，請透過呼叫將 {0,0,0,0} 傳遞給 SetWindowInputRectangle 方法。

您無法在 Right 屬性值小於 Left 屬性值，或是 Bottom 屬性值小於 Top 屬性值的矩形中傳遞。例如，參數值為 {500, 500, 400, 400} 的矩形無效。

可以指定負座標空間中的矩形，但沒有意義，因為這一定會導致視窗無法書寫。

警告

  如果將視窗輸入矩形設定為與 Splitter 控制項 (英文) 或視窗邊框重疊，則可能會在調整視窗大小時發生不可預測的結果。

注意事項：
如果在特定訊息處理常式內呼叫的話，可能會重新輸入這個函式，造成非預期的結果。處理下列訊息時，請小心避免使用可重新進入的呼叫：WM_ACTIVATE、WM_ACTIVATEAPP、WM_NCACTIVATE、WM_PAINT、WM_SYSCOMMAND (如果 wParam 設定為 SC_HOTKEY 或 SC_TASKLIST) 和 WM_SYSKEYDOWN (當處理 ALT+TAB 或 ALT+ESC 組合鍵時)。不過在單一執行緒 Apartment Model (STA) 應用程式中會發生問題。

範例

這個 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