IInkStrokeDisp::GetBoundingBox 方法 (msinkaut.h)
擷取 InkDisp 對象、個別筆劃或 InkStrokes 集合中所有筆劃的筆跡空間座標周框方塊。
語法
HRESULT GetBoundingBox(
[in, optional] InkBoundingBoxMode BoundingBoxMode,
[out, retval] IInkRectangle **Rectangle
);
參數
[in, optional] BoundingBoxMode
選擇性。 指定要用來計算周框方塊的筆劃特性。 默認值為 -1,表示筆劃的所有特性都用來指定周框方塊。
如需使用筆劃特性來計算周框方塊的詳細資訊,請參閱 BoundingBoxMode 列舉類型。
[out, retval] Rectangle
當這個方法傳回時,會包含定義 InkDisp 物件、 IInkStrokeDisp 物件或 InkStrokes 集合周框方塊之矩形的指標。
注意 對於 IInkStrokeDisp 對象,傳回的周框方塊是筆劃周框方塊的複本,因此改變傳回的周框方塊不會影響筆劃位置。
傳回值
這個方法可以傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
|
成功。 |
|
參數包含無效的指標。 |
|
方法內發生例外狀況。 |
|
非預期的參數或屬性類型。 |
|
InkRectangle 物件未註冊。 |
備註
當周框方塊受到畫筆寬度影響時,此寬度會針對 InkRenderer 的檢視轉換適當調整。 若要這樣做,畫筆寬度會乘以檢視轉換行列式的平方根。
注意 在 Windows Vista 和更新版本中, GetBoundingBox 方法 不會將筆劃的寬度納入考慮。
注意 如果您尚未明確設定畫筆寬度,則預設為53。 您必須將畫筆寬度乘以行列式的平方根,才能產生正確的周框方塊。 周框方塊的高度和寬度會以每個方向的一半來展開。 例如,假設畫筆寬度是53、行列式的平方根是50,而周框方塊是 (0、0、1000、1000、1000) 。 每個方向周框方塊的畫筆寬度調整計算為 (53 * 50) / 2,右側和下側邊會遞增一個。 這會導致轉譯的周框方塊 (-1325、-1325、2326、2326) 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP Tablet PC Edition [僅限傳統型應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | msinkaut.h |
程式庫 | InkObj.dll |