IInkDisp：：HitTestCircle 方法 (msinkaut.h)

發行項
02/29/2024

擷取完全位於已知圓形內部或交集的 InkStrokes 集合。

語法

HRESULT HitTestCircle(
  [in]          long        X,
  [in]          long        Y,
  [in]          float       radius,
  [out, retval] IInkStrokes **Strokes
);

參數

[in] X

筆跡空間單位中點擊測試圓形中央的 X 位置。

[in] Y

筆跡空間單位中點擊測試圓形中央的 Y 位置。

[in] radius

在點擊測試中使用的圓形半徑，以筆跡空間單位表示。

[out, retval] Strokes

當這個方法傳回時，會包含完全內或與指定圓形交集的筆劃集合。

傳回值

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

傳回碼	描述
S_OK	成功。
E_POINTER	參數包含無效的指標。
E_INK_EXCEPTION	方法內發生例外狀況。
E_INVALIDARG	無效的顯示句柄。
E_UNEXPECTED	非預期的參數或屬性類型。

備註

如果筆劃與圓形交集，則會傳回完整的筆劃。

方法會計算交集，並考慮套用至筆劃的完整繪圖屬性集，包括完整的畫筆寬度、如果存在) ，則 Bezier 平滑 (，以及手寫筆提示的形狀。

在筆劃或筆劃集合上執行旋轉或變換轉換之後，已 x- 轉換的和 y- 座標不再與原始座標同心。因此， radius 不應該從 x- 或 y- 座標計算自變數。

若要判斷已知筆劃的哪些點與測試區域交集，請呼叫 IInkStrokeDisp 物件的 HitTest 方法。

應用程式必須一律傳入結果筆劃集合的目的地指標。如果沒有交集，集合的計數為零。

規格需求

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