共用方式為

IInkDisp：：HitTestCircle 方法 (msinkaut.h)

  • 發行項

擷取完全位於已知圓形內部或交集的 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

另請參閱

HitTest (Point[]， Single) 方法

HitTest (Rectangle、Single) 方法

IInkDisp

InkDisp 類別

InkStrokes 集合