IInkStrokeDisp::GetRectangleIntersections 方法 (msinkaut.h)

尋找 IInkStrokeDisp 物件與特定矩形相交的點。

語法

HRESULT GetRectangleIntersections(
  [in]          IInkRectangle *Rectangle,
  [out, retval] VARIANT       *Intersections
);

參數

[in] Rectangle

墨 水空間 座標中的矩形,描述命中測試區域。

[out, retval] Intersections

當此方法返回時,包含一個 VARIANT 陣列,指示筆劃與 矩形的交點。 起始浮點數索引會儲存在偶數索引中。 尾部浮點數索引儲存在奇數索引中。 第一對指標代表第一個交點。

欲了解更多關於 VARIANT 結構的資訊,請參閱 使用 COM 函式庫。

返回值

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

回傳碼 說明
S_OK
成功。
E_POINTER
某個參數包含無效指標。
E_OUTOFMEMORY
無法分配 Stroke handler 助手物件。
E_UNEXPECTED
非預期的參數或屬性類型。
E_INK_EXCEPTION
方法中出現了例外。

備註

此方法會回傳一個陣列,指示筆劃與指定矩形的交點。 每一段與矩形相交的線段都是一對索引,交替出現一個起始索引,接著是一個結束索引。

若筆劃開始於測試矩形內,第一個索引設為 -1。 若筆劃結束於測試矩形內,最後一個索引設為 -1。 若筆劃完全超出測試矩形,則回傳一個空陣列。 例如,如果筆劃從測試矩形內部開始,離開矩形邊界,再回到裡面,再離開,則 GetRectangleIntersections 方法可能會回傳 {-1, 1.4, 5.5, 10.1} 來描述劃線中落在矩形內的兩個段落。

要求

需求 價值
最低支援的用戶端 Windows XP 平板電腦版【僅限桌面應用程式】
支援的最低伺服器 不支援
目標平臺 Windows
Header msinkaut.h

另請參閱

剪輯法

尋找交點法

IInkStrokeDisp 介面