共用方式為


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

當這個方法傳回時,會包含組成筆跡之筆劃集合的指標。

傳回值

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

傳回碼 描述
S_OK
成功。
E_POINTER
參數包含無效的指標。
E_INK_EXCEPTION
方法內發生例外狀況。
E_INVALIDARG
無效的顯示句柄。
E_OUTOFMEMORY
無法配置記憶體作業。

規格需求

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

另請參閱

HitTest (Point、Single) 方法

HitTest (Rectangle、Single) 方法

IInkDisp

InkDisp 類別

InkStrokes 集合