共用方式為

IInkStrokes：：GetBoundingBox 方法 (msinkaut.h)

  • 發行項

取得 InkDisp 對象、個別筆劃或 InkStrokes 集合中所有筆劃的筆跡空間座標周框方塊。

語法

HRESULT GetBoundingBox(
  [in, optional] InkBoundingBoxMode BoundingBoxMode,
  [out, retval]  IInkRectangle      **BoundingBox
);

參數

[in, optional] BoundingBoxMode

選擇性。 指定要用來計算周框方塊的筆劃特性。 如需使用筆劃特性來計算周框方塊的詳細資訊，請參閱 BoundingBoxMode 列舉類型。

GetBoundingBox 方法的 BoundingBoxMode 參數的預設值為 -1，這表示筆劃的所有特性都會用來指定周框方塊。

[out, retval] BoundingBox

當這個方法傳回時，會包含定義 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) 。 每個方向的周框方塊的畫筆寬度調整會計算為 (53 * 50) / 2，而右邊和底端則會遞增一個。 這會導致轉譯的周框方塊 (-1325、-1325、2326、2326) 。
 

規格需求

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

另請參閱

IInkStrokes

InkBoundingBoxMode 列舉

InkRectangle 類別

InkStrokes 集合