IInkStrokeDisp::SetPoints 方法 (msinkaut.h)
使用 X、Y 值的陣列,設定 IInkStrokeDisp 的點。
語法
HRESULT SetPoints(
[in] VARIANT Points,
[in, optional] long Index,
[in, optional] long Count,
[out, retval] long *NumberOfPointsSet
);
參數
[in] Points
新點的陣列,用來取代從 索引開始的筆劃中的點。 這是 VARIANT,其中包含 Long 的陣列,其中包含以 x0、y0、x1、y1、x2、y2 等形式交替值所代表的點。
如需 VARIANT 結構的詳細資訊,請參閱 使用 COM 連結庫。
[in, optional] Index
選擇性。 要修改之筆劃中第一個點之以零起始的索引。 在 ItemSelectionConstants 列舉類型中定義的預設值ISC_FirstElement,指定修改筆劃中的第一個點。
[in, optional] Count
選擇性。 要修改之筆劃中的點數。 在 ItemSelectionConstants 列舉類型中定義的預設值 ISC_AllElements,指定修改筆劃中的所有點。
[out, retval] NumberOfPointsSet
當這個方法傳回時,會包含實際設定的封包數目。
傳回值
這個方法可以傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
|
成功。 |
|
參數包含無效的指標。 |
|
索引 ( 超出範圍) 或 points 參數。 格式不正確。 |
|
方法內發生例外狀況。 |
備註
此方法不會變更筆劃中的點數。 若要變更筆劃中的點數,必須建立新的筆劃,或必須分割筆劃。
這個方法不提供截斷筆劃。 如果點陣列包含的點數少於筆劃,則不會修改筆劃中點的其餘部分。
這個方法不提供擴充筆劃。 如果 points 陣列包含的點數超過筆劃,則不會使用額外的點。 如果計數超過陣列中的點數,則只會修改陣列中的點數。
若要在呼叫 SetPoints 之後繪製筆劃,請呼叫 InvalidateRect 函式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP Tablet PC Edition [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | msinkaut.h |
程式庫 | InkObj.dll |