共用方式為


IInkStrokeDisp::NearestPoint 方法 (msinkaut.h)

尋找最接近已知點的筆劃位置,並傳回點從筆劃的距離。 所有項目都位於筆跡空間座標中。

語法

HRESULT NearestPoint(
  [in]                long  X,
  [in]                long  Y,
  [in, out, optional] float *Distance,
  [out, retval]       float *Point
);

參數

[in] X

要測試之點筆跡空間中的 X 位置。

[in] Y

要測試之點筆跡空間中的 Y 位置。

[in, out, optional] Distance

選擇性。 從點到筆劃的距離。 此參數可以是 Null。 預設值為 0。

[out, retval] Point

這個方法傳回時,會包含浮點索引值,代表筆劃上最接近的位置。

浮點索引是浮點數,代表筆劃中兩個點之間的某個位置。 例如,如果0.0是筆劃中的第一個點,而1.0是筆劃中的第二個點,則0.5會在第一和第二個點之間一半。 同樣地,浮點索引值為 37.25 代表沿著筆劃 37 到 38 點之間的線條 25% 的位置。

傳回值

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

傳回碼 描述
S_OK
成功。
E_POINTER
參數包含無效的指標。
E_FAIL
發生未指定的錯誤。
E_INK_EXCEPTION
方法內發生例外狀況。

備註

distance 參數描述從點到筆劃信封的距離。 這是兩點之間的距離減去筆劃寬度的一半。

規格需求

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

另請參閱

GetRectangleIntersections 方法

HitTest (Point、Single) 方法

IInkStrokeDisp 介面

NearestPoint 方法 [InkDisp 類別]