IInkPicture：：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_ACTIVATE、 WM_ACTIVATEAPP、 WM_NCACTIVATE、 WM_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 方法

IInkPicture

InkPicture