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 集合