Strokes.GetBoundingBox 方法 (BoundingBoxMode)

项目
11/04/2008

通过使用指定的 BoundingBoxMode 标志确定边界，返回包含 Stroke 对象的边框 Rectangle。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
Public Function GetBoundingBox ( _
    mode As BoundingBoxMode _
) As Rectangle
用法
Dim instance As Strokes
Dim mode As BoundingBoxMode
Dim returnValue As Rectangle

returnValue = instance.GetBoundingBox(mode)

public Rectangle GetBoundingBox(
    BoundingBoxMode mode
)

public:
Rectangle GetBoundingBox(
    BoundingBoxMode mode
)

public Rectangle GetBoundingBox(
    BoundingBoxMode mode
)

public function GetBoundingBox(
    mode : BoundingBoxMode
) : Rectangle

参数

mode
类型：Microsoft.Ink.BoundingBoxMode
BoundingBoxMode 枚举的一个成员，指定使用 Strokes 集合的哪些特征（例如绘制属性）计算 Strokes 集合的边界框。

返回值

类型：System.Drawing.Rectangle
返回定义 Strokes 集合边界框的边框 Rectangle。

备注

边框 Rectangle 采用墨迹空间 坐标。

边框 Rectangle 对应于显示 Strokes 集合时将要失效或重绘的显示部分。

边界框会进行缓存，用于除 BoundingBoxMode 模式以外的所有模式。

如果边界框受到笔宽度的影响，则此宽度根据 Renderer 对象的视图变换进行相应缩放。为此，笔宽度将乘以视图变换的行列式的平方根。

备注

如果没有显式设置笔宽度，则默认值为 53。只有将笔宽度乘以行列式的平方根才能得到正确的边界框。边界框的高度和宽度在每个方向上扩展该数量的一半。例如，如果笔宽度为 53，行列式的平方根为 50，边界框为 (0, 0, 1000, 1000)。根据笔宽度，边界框在每个方向上的调整计算方法为 (53 * 50) / 2，右侧和下方增加一个单位。这样，将呈现出边界框 (-1325, -1325, 2326, 2326)。

备注

此方法返回的边框 Rectangle 是 Strokes 集合的边界框的副本。修改此方法返回的 Rectangle 不影响原始 Strokes 集合的边界框。

示例

在此示例中，InkOverlay 对象的 Strokes 集合将进行缩放以适合原始边界框的左半边。首先，通过使用 BoundingBoxMode 枚举的 CurveFit 值确定边界框的边界，并调用 GetBoundingBox 方法获得 Strokes 集合的边框。然后，创建具有原始边框一半宽度的新边框并传递给 ScaleToRectangle 方法。

' Access to the Strokes property returns a copy of the Strokes object.
' This copy must be implicitly (via using statement) or explicitly
' disposed of in order to avoid a memory leak.
Using allStrokes As Strokes = mInkOverlay.Ink.Strokes
    Dim bounds As Rectangle = allStrokes.GetBoundingBox(BoundingBoxMode.CurveFit)
    Dim halfRectangle As Rectangle = _
            New Rectangle(bounds.Left, bounds.Top, bounds.Width / 2, bounds.Height)
    allStrokes.ScaleToRectangle(halfRectangle)
End Using

// Access to the Strokes property returns a copy of the Strokes object.
// This copy must be implicitly (via using statement) or explicitly
// disposed of in order to avoid a memory leak.
using (Strokes allStrokes = mInkOverlay.Ink.Strokes)
{
    Rectangle bounds = allStrokes.GetBoundingBox(BoundingBoxMode.CurveFit);
    Rectangle halfRectangle = 
        new Rectangle(bounds.Left, bounds.Top, bounds.Width / 2, bounds.Height);
    allStrokes.ScaleToRectangle(halfRectangle);
}