IInkDisp::HitTestWithLasso 方法 (msinkaut.h)
擷取聚合線選取區域內的筆劃。
語法
HRESULT HitTestWithLasso(
[in] VARIANT Points,
[in] float IntersectPercent,
[in, out, optional] VARIANT *LassoPoints,
[out, retval] IInkStrokes **Strokes
);
參數
[in] Points
選取工具中用來選取筆劃的點。 選取區域是選取界限內第一個交集本身的區域。 如果界限本身不相交,方法會將點新增至陣列結尾,以建立從第一個點到最後一個點的直線。 如果界限是直線, (選取界限內沒有區域) ,則不會選取任何筆劃。
如需 VARIANT 結構的詳細資訊,請參閱 使用 COM 連結庫。
[in] IntersectPercent
必須包含在選取工具內的筆劃點百分比,以在產生的筆劃集合中包含筆劃。 如果零 (0
) ,則選取工具內含或交集的所有筆劃都會包含在產生的筆劃集合中。 如果為 100,則集合中只會包含選取工具中完全包含的筆劃。 如果選取工具中包含的筆劃中點百分比大於或等於 percentIntersect 百分比,則與選取工具中交集選取工具的筆劃會包含在集合中。 小數百分比會四捨五入。
[in, out, optional] LassoPoints
選擇性。 擷取用於選取範圍之選取工具的特定部分。 因為使用者可以繪製許多不同類型的選取工具,所以其中有些會重疊多次,這很適合用來說明選取工具的哪個部分用於選取。 默認值為 NULL 指標,這表示不會傳回任何資訊。
如需 VARIANT 結構的詳細資訊,請參閱 使用 COM 連結庫。
[out, retval] Strokes
當這個方法傳回時,會包含組成筆跡之筆劃集合的指標。
傳回值
這個方法可以傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
|
成功。 |
|
參數包含無效的指標。 |
|
方法內發生例外狀況。 |
|
無效的顯示句柄。 |
|
無法配置記憶體作業。 |
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP Tablet PC Edition [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | msinkaut.h |
程式庫 | InkObj.dll |