IInkCollector::SetWindowInputRectangle 方法 (msinkaut.h)
設定繪製筆跡的視窗矩形,以圖元為單位。
語法
HRESULT SetWindowInputRectangle(
[in] IInkRectangle *WindowInputRectangle
);
參數
[in] WindowInputRectangle
在視窗座標中繪製筆跡的矩形。
傳回值
這個方法可以傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
|
成功。 |
|
參數包含不正確指標。 |
|
矩形座標無效 (例如,寬度/高度為 0) 。 |
|
在筆劃中間時無法更新對應。 |
|
方法內發生例外狀況。 |
|
視窗輸入矩形與已啟用 InkCollector 的視窗輸入矩形重迭。 |
備註
如果已啟用的筆跡收集器視窗輸入矩形 (與 Enabled 屬性設定) 與另一個已啟用筆跡收集器的視窗輸入矩形重迭,就會傳回E_INK_OVERLAPPING_INPUT_RECT錯誤。
注意 只要在任何已知時間只啟用其中一個輸入矩形,就可能發生重迭而不發生錯誤。
若要將視窗輸入矩形重設為其預設行為, (具有座標 {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 |