共用方式為

IInkCollector：：SetWindowInputRectangle 方法 (msinkaut.h)

  • 發行項

設定繪製筆跡的視窗矩形，以圖元為單位。

語法

HRESULT SetWindowInputRectangle(
  [in] IInkRectangle *WindowInputRectangle
);

參數

[in] WindowInputRectangle

在視窗座標中繪製筆跡的矩形。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼 描述
S_OK
 成功。
E_POINTER
 參數包含不正確指標。
E_INVALIDARG
 矩形座標無效 (例如，寬度/高度為 0) 。
E_INK_COLLECTOR_BUSY
 在筆劃中間時無法更新對應。
E_INK_EXCEPTION
 方法內發生例外狀況。
E_INK_OVERLAPPING_INPUT_RECT
 視窗輸入矩形與已啟用 InkCollector 的視窗輸入矩形重迭。

備註

如果已啟用的筆跡收集器視窗輸入矩形 (與 Enabled 屬性設定) 與另一個已啟用筆跡收集器的視窗輸入矩形重迭，就會傳回E_INK_OVERLAPPING_INPUT_RECT錯誤。

注意 只要在任何已知時間只啟用其中一個輸入矩形，就可能發生重迭而不發生錯誤。
 
根據預設，視窗輸入矩形會設定為 {0,0,0,0} 。 這個預設矩形會對應至整個視窗的大小。

若要將視窗輸入矩形重設為其預設行為， (具有座標 {0,0,0,0} 的空白矩形) ，請傳入 {0,0,0,0}對 SetWindowInputRectangle的呼叫，而不是 Null。

您無法傳入 Right 屬性的值小於 Left 屬性值的矩形;或 ，其中 Bottom 屬性的值小於 Top 屬性的值。 例如，參數為 {500、500、400、 400} 的矩形無效。

謹慎 如果您將視窗輸入矩形設定為重迭分隔器控制項或視窗的框線，當視窗調整大小時，可能會發生無法預期的結果。
 
注意 在特定訊息處理常式內呼叫這個方法可能會導致重新輸入基礎函式，導致非預期的結果。 處理下列任何訊息時，請小心避免重新進入呼叫： WM_ACTI加值稅E、 WM_ACTI加值稅EAPP、 WM_NCACTI加值稅EWM_PAINT; 如果wParam 設定為 SC_HOTKEY 或 SC_TASKLIST，則為 WM_SYSCOMMAND;和 WM_SYSKEYDOWN (處理 Alt+TAB 或 Alt+ESC 按鍵組合時) 。 這是單一執行緒 Apartment 模型應用程式的問題。
 

需求

   
最低支援的用戶端 Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 msinkaut.h
程式庫 InkObj.dll

另請參閱

Enabled 屬性

GetWindowInputRectangle 方法

IInkCollector

InkCollector 類別