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 對象，傳回的周框方塊是筆劃周框方塊的複本，因此改變傳回的周框方塊不會影響筆劃位置。

 

傳回值

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

傳回碼	描述
S_OK	成功。
E_POINTER	參數包含無效的指標。
E_INK_EXCEPTION	方法內發生例外狀況。
E_UNEXPECTED	非預期的參數或屬性類型。
REGDB_CLASSNOTREG	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

另請參閱

IInkStrokeDisp 介面

InkBoundingBoxMode 列舉

InkRectangle 類別